home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Latest Shareware Programs: Warp / OS-2 WARP - Latest Shareware Programs.iso / zipped.os2 / bbs / max202c.lzh / max_op.doc < prev    next >
Text File  |  1994-11-01  |  315KB  |  7,969 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.                                  Maximus Version 2.02
  23.                                System Operations Manual
  24.  
  25.  
  26.                               Created November 1, 1994.
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.           Copyright 1990, 1994 by Lanius Corporation.  All rights reserved.
  56.                Maximus and Squish are trademarks of Lanius Corporation.
  57.  
  58.  
  59.  
  60.                                   TABLE OF CONTENTS
  61.  
  62.           LICENCE . . . . . . . . . . . . . . . . . . . . . . . . . . .   1
  63.                Contact Information  . . . . . . . . . . . . . . . . . .   3
  64.  
  65.           INTRODUCTION  . . . . . . . . . . . . . . . . . . . . . . . .   4
  66.                About Maximus  . . . . . . . . . . . . . . . . . . . . .   4
  67.                Notes from the Author  . . . . . . . . . . . . . . . . .   5
  68.                Maximus, Money and You . . . . . . . . . . . . . . . . .   6
  69.                Ordering Information . . . . . . . . . . . . . . . . . .   6
  70.                Credits  . . . . . . . . . . . . . . . . . . . . . . . .   7
  71.  
  72.           SYSTEM REQUIREMENTS . . . . . . . . . . . . . . . . . . . . .   9
  73.  
  74.           MAXIMUS OVERVIEW  . . . . . . . . . . . . . . . . . . . . . .  10
  75.                Logging On . . . . . . . . . . . . . . . . . . . . . . .  10
  76.                The Main Menu  . . . . . . . . . . . . . . . . . . . . .  12
  77.                The Message Section  . . . . . . . . . . . . . . . . . .  15
  78.                The Message Menu . . . . . . . . . . . . . . . . . . . .  16
  79.                Message Entry  . . . . . . . . . . . . . . . . . . . . .  23
  80.                Message Editors  . . . . . . . . . . . . . . . . . . . .  24
  81.                The File Menu  . . . . . . . . . . . . . . . . . . . . .  28
  82.                The Change Setup Menu  . . . . . . . . . . . . . . . . .  32
  83.                The SysOp Menu . . . . . . . . . . . . . . . . . . . . .  36
  84.                The Chat Menu  . . . . . . . . . . . . . . . . . . . . .  37
  85.                The Off-Line Reader Menu . . . . . . . . . . . . . . . .  38
  86.  
  87.           INSTALLATION INSTRUCTIONS . . . . . . . . . . . . . . . . . .  40
  88.                Step 1:   Where do I put these files?  . . . . . . . . .  40
  89.                Step 2:   Configuring your Modem . . . . . . . . . . . .  42
  90.                Step 3:   Installing a communications driver . . . . . .  44
  91.                Step 4:   Editing Configuration Files  . . . . . . . . .  47
  92.                Step 5:   Setting Up Control Files . . . . . . . . . . .  49
  93.                Step 6:   Compiling the Control Files  . . . . . . . . .  50
  94.                Step 7:   Starting Maximus . . . . . . . . . . . . . . .  51
  95.                Step 8:   Support for Remote Callers . . . . . . . . . .  52
  96.                Step 9:   Events and Yelling . . . . . . . . . . . . . .  62
  97.                Step 10:  About Priv Levels and Locks  . . . . . . . . .  64
  98.                Step 11:  Customizing *.BBS Files  . . . . . . . . . . .  66
  99.                Step 12:  Customizing Msg/File Areas . . . . . . . . . .  68
  100.                Step 13:  Maintaining File Areas . . . . . . . . . . . .  72
  101.                Step 14:  Customizing Menus  . . . . . . . . . . . . . .  76
  102.                Step 15:  Configuring the QWK Mail Packer  . . . . . . .  77
  103.                Step 16:  Miscellaneous Information  . . . . . . . . . .  78
  104.  
  105.           MAXIMUS UTILITY DOCUMENTATION . . . . . . . . . . . . . . . .  79
  106.                ACCEM:  MECCA Decompiler . . . . . . . . . . . . . . . .  79
  107.                ANS2BBS/MEC:  ANSI to MEC conversion . . . . . . . . . .  81
  108.                CVTUSR:  User File Conversions . . . . . . . . . . . . .  83
  109.                EDITCAL:  Call Fudging Utility . . . . . . . . . . . . .  85
  110.                FB:  File Database Compiler  . . . . . . . . . . . . . .  86
  111.                MAID:  Language File Compiler  . . . . . . . . . . . . .  89
  112.  
  113.  
  114.  
  115.                MAXPIPE:  OS/2 Redirection Utility . . . . . . . . . . .  91
  116.                MECCA:  Display File Compiler  . . . . . . . . . . . . .  92
  117.                MR:  Maximus Renumbering Program . . . . . . . . . . . .  93
  118.                ORACLE:  Display File Viewer . . . . . . . . . . . . . .  94
  119.                PMSNOOP:  OS/2 Presentation Manager Monitoring Utility .  96
  120.                SCANBLD:  *.MSG Database Builder . . . . . . . . . . . .  97
  121.                SILT:  Control File Compiler . . . . . . . . . . . . . . 100
  122.  
  123.           RUNNING EXTERNAL PROGRAMS . . . . . . . . . . . . . . . . . . 102
  124.                Execution Methods  . . . . . . . . . . . . . . . . . . . 102
  125.                ErrorLevel Batch Files . . . . . . . . . . . . . . . . . 103
  126.                Restarting After Chain/Errorlevel  . . . . . . . . . . . 105
  127.                External Program Translation Characters  . . . . . . . . 107
  128.                Running Doors  . . . . . . . . . . . . . . . . . . . . . 110
  129.                On-Line User Record Modification . . . . . . . . . . . . 114
  130.                Doors under OS/2 . . . . . . . . . . . . . . . . . . . . 115
  131.  
  132.           MULTI-LINE OPERATION GUIDE  . . . . . . . . . . . . . . . . . 116
  133.                Installation . . . . . . . . . . . . . . . . . . . . . . 116
  134.                Multi-Node Chat Operation  . . . . . . . . . . . . . . . 118
  135.  
  136.           USING CUSTOM MENUS  . . . . . . . . . . . . . . . . . . . . . 121
  137.  
  138.           WAITING FOR CALLER SUBSYSTEM  . . . . . . . . . . . . . . . . 123
  139.                Starting WFC . . . . . . . . . . . . . . . . . . . . . . 123
  140.                Screen Display and SysOp Keys  . . . . . . . . . . . . . 123
  141.  
  142.           EXPIRATION/SUBSCRIPTION SYSTEM  . . . . . . . . . . . . . . . 125
  143.  
  144.           MULTILINGUAL SUPPORT  . . . . . . . . . . . . . . . . . . . . 126
  145.  
  146.           QWK MAIL PACKER . . . . . . . . . . . . . . . . . . . . . . . 128
  147.                Configuration  . . . . . . . . . . . . . . . . . . . . . 128
  148.                Bulletins, News Files and File Lists . . . . . . . . . . 128
  149.                Remote Message Packing . . . . . . . . . . . . . . . . . 129
  150.                Local Mail Packing . . . . . . . . . . . . . . . . . . . 130
  151.                Unattended Mail Packing ("Vacation Saver") . . . . . . . 130
  152.                NetMail Messages . . . . . . . . . . . . . . . . . . . . 131
  153.  
  154.           MISCELLANEOUS INFORMATION . . . . . . . . . . . . . . . . . . 132
  155.                Filename Specifications  . . . . . . . . . . . . . . . . 132
  156.                Hard-Coded Filenames . . . . . . . . . . . . . . . . . . 132
  157.  
  158.           INDEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
  159.  
  160.  
  161.  
  162.                                        LICENCE
  163.  
  164.           (C) Copyright 1989, 1994 by Lanius Corporation.  All rights
  165.           reserved.
  166.  
  167.           COMMERCIAL DISTRIBUTION AND/OR USE PROHIBITED WITHOUT WRITTEN
  168.           CONSENT FROM LANIUS CORPORATION.
  169.  
  170.  
  171.           Noncommercial distribution and/or use is permitted under the
  172.           following terms:
  173.  
  174.           1)   You may copy and distribute verbatim copies of the Maximus
  175.                documentation and executable code as you receive it, in any
  176.                medium, provided that you conspicuously and appropriately
  177.                publish on each copy a valid copyright notice "Copyright
  178.                1989, 1994 by Lanius Corporation"; keep intact the notices
  179.                on all files that refer to this Licence Agreement and to the
  180.                absence of any warranty;  PROVIDE UNMODIFIED COPIES OF THE
  181.                DOCUMENTATION AS PROVIDED WITH THE PROGRAM; and give any
  182.                other recipients of the Maximus program a copy of this
  183.                Licence Agreement along with the program.  You may charge a
  184.                distribution fee for the physical act of transferring a
  185.                copy, but no more than is necessary to recover your actual
  186.                costs incurred in the transfer.
  187.  
  188.           2)   Mere aggregation of another unrelated program with this
  189.                program and documentation (or derivative works) on a volume
  190.                of a storage or distribution medium does not bring the other
  191.                program under the scope of these terms.
  192.  
  193.           3)   You may not copy, sublicense, distribute or transfer Maximus
  194.                and its associated documentation except as expressly
  195.                provided under this Licence Agreement.  Any attempt
  196.                otherwise to copy, sublicense, distribute or transfer
  197.                Maximus is void and your rights to use the program under
  198.                this Licence agreement shall be automatically terminated.
  199.  
  200.                However, parties who have received computer software
  201.                programs from you with this Licence Agreement will not have
  202.                their licences terminated so long as such parties remain in
  203.                full compliance, and notify Lanius Corporation of their
  204.                intention to comply with this Agreement.
  205.  
  206.           4)   You may not incorporate all or part of Maximus (including
  207.                related utilities) into a program which is not completely
  208.                free for all users.  If you wish to distribute Maximus in
  209.                this manner, you must obtain written permission from Lanius
  210.                Corporation.
  211.  
  212.  
  213.                     Maximus 2.02 System Operations Manual - Page 1
  214.  
  215.  
  216.  
  217.           5)   The privileges granted above apply only to noncommercial
  218.                users of the Maximus software.
  219.  
  220.                You are a NONCOMMERCIAL user only if you are running Maximus
  221.                as a private individual with no "sponsors", "backers", and
  222.                only if your BBS is not making (or helping to make) a
  223.                profit.
  224.  
  225.                You are a COMMERCIAL user if you make a profit from running
  226.                your BBS.
  227.  
  228.                You are also a COMMERCIAL user if your BBS is being run by
  229.                (or for) a corporation, government, company, foundation, or
  230.                any other organization.
  231.  
  232.                You are also a COMMERCIAL user if your system is used to
  233.                advertise for such a commercial organization for the
  234.                purposes of making a profit.
  235.  
  236.                This licence only governs NONCOMMERCIAL users.  If you are a
  237.                COMMERCIAL user, you are not licensed to use or distribute
  238.                this software without the prior written consent of Lanius
  239.                Corporation.  If you wish to run Maximus as a commercial
  240.                user, please see the section of the program documentation
  241.                entitled "Ordering Information".
  242.  
  243.           6)   This licence may be revoked by Lanius Corporation without
  244.                prior notice.
  245.  
  246.                                      NO WARRANTY
  247.  
  248.           WE PROVIDE ABSOLUTELY NO WARRANTY.  EXCEPT WHEN OTHERWISE STATED
  249.           IN WRITING, LANIUS CORPORATION AND/OR OTHER PARTIES PROVIDE
  250.           MAXIMUS "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR
  251.           IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  252.           MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE
  253.           RISK AS TO THE QUALITY AND PERFORMANCE OF MAXIMUS, AND THE
  254.           ACCURACY OF ITS ASSOCIATED DOCUMENTATION, IS WITH YOU.  SHOULD
  255.           MAXIMUS OR ITS ASSOCIATED DOCUMENTATION PROVE DEFECTIVE, YOU
  256.           ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
  257.  
  258.           IN NO EVENT WILL LANIUS CORPORATION BE RESPONSIBLE IN ANY WAY FOR
  259.           THE BEHAVIOUR OF MODIFIED VERSIONS OF MAXIMUS.  IN NO EVENT WILL
  260.           LANIUS CORPORATION AND/OR ANY OTHER PARTY WHO MAY MODIFY AND
  261.           REDISTRIBUTE MAXIMUS AS PERMITTED ABOVE, BE LIABLE TO YOU FOR
  262.           DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR OTHER
  263.           SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
  264.           USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF
  265.           DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  266.  
  267.  
  268.                     Maximus 2.02 System Operations Manual - Page 2
  269.  
  270.  
  271.  
  272.           THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY
  273.           OTHER PROGRAMS) MAXIMUS, EVEN IF LANIUS CORPORATION HAS BEEN
  274.           ADVISED OF THE POSSIBILITY OF SUCH DAMAGES, OR FOR ANY CLAIM BY
  275.           ANY OTHER PARTY.
  276.  
  277.  
  278.           Contact Information
  279.  
  280.           You can contact Lanius Corporation at any of the addresses listed
  281.           below:
  282.  
  283.           FidoNet:    Scott Dudley @ 1:249/106
  284.           Internet:   sales@lanius.com (commercial inquiries)
  285.                       tech@lanius.com (technical support)
  286.           CompuServe: >INTERNET:sales@lanius.com (commercial inquiries)
  287.                       >INTERNET:tech@lanius.com (technical support)
  288.           BBS:        +1-613-389-8315 (V.32bis)
  289.           FAX:        +1-613-634-3058
  290.  
  291.           Surface mail:
  292.  
  293.                Lanius Corporation
  294.                777 Downing St.
  295.                Kingston, Ont.
  296.                Canada  K7M 5N3
  297.  
  298.           Lanius Corporation can also be reached through the FidoNet
  299.           EchoMail conferences called MUFFIN (Maximus support) and TUB
  300.           (Squish support).
  301.  
  302.           Electronic correspondence is strongly preferred and the use of
  303.           surface mail is discouraged.  If you must send paper mail (and
  304.           expect to receive a reply), please enclose a self-addressed,
  305.           stamped envelope.  Users outside of Canada should include an
  306.           international postal reply coupon instead of a stamp.
  307.  
  308.           NONCOMMERCIAL USERS SHOULD NOT ATTEMPT TO CONTACT LANIUS
  309.           CORPORATION BY TELEPHONE.  WE ARE NOT ABLE TO PROVIDE VOICE
  310.           SUPPORT FOR NON-PAYING CUSTOMERS.
  311.  
  312.           Please feel free to contact Lanius Corporation at any time to
  313.           share your comments about this software and/or licensing
  314.           policies.
  315.  
  316.           Our thanks go to the Free Software Foundation for most of the
  317.           wording of this licence.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.                     Maximus 2.02 System Operations Manual - Page 3
  324.  
  325.  
  326.  
  327.                                      INTRODUCTION
  328.  
  329.           About Maximus
  330.  
  331.           Maximus is a flexible bulletin board package for the DOS and
  332.           OS/2 environments.  Maximus comes in both a real-mode DOS version
  333.           and a protected-mode OS/2 version.
  334.  
  335.           In addition to the standard message and file features found in
  336.           most BBS programs, Maximus also includes:
  337.  
  338.           *    Support for the Squish message format, a flat-file database
  339.                message format.
  340.  
  341.           *    A powerful "browse" feature that allows selection of
  342.                messages based on user-defined search criteria.
  343.  
  344.           *    A built-in QWK package for off-line message reading.
  345.  
  346.           *    Full multilingual support.  At the time of this writing,
  347.                third-party language files were available for Cantonese,
  348.                Danish, French, German, Italian, Hungarian, Portuguese,
  349.                Russian, Spanish, and Swedish.  Maximus also includes
  350.                support for Swedish 7-bit characters and the Chinese BIG5
  351.                character set.
  352.  
  353.           *    Maximus supports a theoretically unlimited number of message
  354.                and file areas.
  355.  
  356.           *    Low memory requirements.  The DOS version of Maximus
  357.                requires only 140-160K of RAM.  (Memory requirements for
  358.                Maximus-OS/2 are inconsequential.)
  359.  
  360.           *    A flexible, internal full-screen editor.
  361.  
  362.           *    A built-in multi-node chat feature including virtual CB
  363.                channels and private chats.
  364.  
  365.           *    Internal file transfer protocols, including Zmodem, Ymodem-G
  366.                and other popular file transfer protocols.
  367.  
  368.  
  369.  
  370.  
  371.  
  372.  
  373.  
  374.  
  375.  
  376.  
  377.  
  378.                     Maximus 2.02 System Operations Manual - Page 4
  379.  
  380.  
  381.  
  382.  
  383.           Notes from the Author
  384.  
  385.           Maximus 2.02 is a minor maintenance upgrade to Maximus 2.00. 
  386.           This release fixes a number of small problems in the Maximus 2.00
  387.           and 2.01wb distributions.
  388.  
  389.           However, 2.02 also includes a new file transfer protocol engine. 
  390.           This new engine includes support for Ymodem and Ymodem-G, in
  391.           addition to faster implementations of the previously-existing
  392.           protocols.
  393.  
  394.           Maximus 2.02 will probably the last release of Maximus from the
  395.           version 2.x source code tree.  Maximus 3.0 has already been in
  396.           development for over two years, and it will include some features
  397.           which are not currently found in any other BBS package.
  398.  
  399.           If you have trouble installing Maximus, in spite of the automated
  400.           installation program, please have a look in the troubleshooting
  401.           section of this manual.  If you still cannot get Maximus to work
  402.           correctly, then either post a message in the MUFFIN echomail
  403.           conference, or send NetMail to the Maximus Help node at 1:1/119.
  404.  
  405.           Scott Dudley
  406.           November 1st, 1994
  407.  
  408.           For contact information, please see the program licence.
  409.  
  410.  
  411.  
  412.  
  413.  
  414.  
  415.  
  416.  
  417.  
  418.  
  419.  
  420.  
  421.  
  422.  
  423.  
  424.  
  425.  
  426.  
  427.  
  428.  
  429.  
  430.  
  431.  
  432.  
  433.                     Maximus 2.02 System Operations Manual - Page 5
  434.  
  435.  
  436.  
  437.  
  438.           Maximus, Money and You
  439.  
  440.           In general, Maximus is a freeware program for noncommercial users
  441.           only.  If you are a noncommercial user and you abide by the terms
  442.           given in the licence, there is NO CHARGE for running Maximus. 
  443.           NONCOMMERCIAL USERS ARE STILL WELCOME TO RUN MAXIMUS WITHOUT
  444.           PAYING A CENT.
  445.  
  446.           Unlike other software, this program has no crippled features,
  447.           extra bells'n'whistles or "registration incentives".  There is
  448.           one simple difference between the commercial and noncommercial
  449.           versions of Maximus:  the commercial version entitles you to
  450.           legally use Maximus in a commercial environment.
  451.  
  452.           If you are a COMMERCIAL USER as defined in point 5) of the
  453.           licence above, you must obtain a licence before using Maximus. 
  454.           Please see ORDER.FRM for more information.  If you did not
  455.           receive a copy of the order form with this document, contact the
  456.           author at one of the addresses listed in the licence for more
  457.           information.
  458.  
  459.           If you are a NONCOMMERCIAL user as defined in the licence above,
  460.           you are welcome to use Maximus for free.  However, Maximus is an
  461.           extremely large and complex program, and simply maintaining the
  462.           existing code is consuming a large amount of time.  Donations of
  463.           any value (or even just a postcard) will be gladly accepted. 
  464.           However, noncommercial donations are on a VOLUNTARY basis and are
  465.           NOT REQUIRED.
  466.  
  467.           However, please read the program licence carefully, since
  468.           additional restrictions or qualifications may apply to you.
  469.  
  470.  
  471.           Ordering Information
  472.  
  473.           Please see the ORDER.FRM file (included in the Maximus
  474.           distribution package) for information on ordering a copy of
  475.           Maximus for commercial use.
  476.  
  477.  
  478.  
  479.  
  480.  
  481.  
  482.  
  483.  
  484.  
  485.  
  486.  
  487.  
  488.                     Maximus 2.02 System Operations Manual - Page 6
  489.  
  490.  
  491.  
  492.  
  493.           Credits
  494.  
  495.           Even though Maximus is almost all original code, several other
  496.           people contributed a great deal to the project and deserve to be
  497.           acknowledged.
  498.  
  499.           First and foremost, my thanks go to Wynn Wagner III.  Without
  500.           Wynn, there would be no Opus; without Opus, there would be no
  501.           Maximus, or at least not in the form that it is today.  Maximus
  502.           does not use any of Wynn's code, but he did provide the program
  503.           after which Maximus was originally modeled.  Wynn also wrote a
  504.           large number of utilities and established the WaZOO handshaking
  505.           standard.
  506.  
  507.           Secondly, my thanks go to Peter Fitzsimmons for all of his help
  508.           and code.  Peter did the original OS/2 port of the code, but he
  509.           has also contributed a good deal of code to the DOS version as
  510.           well.
  511.  
  512.           I would also be remiss if I failed to thank all of my alpha and
  513.           beta testers.  Although the list is too long to include here, my
  514.           sincere gratitude goes out to all of them, not only for their
  515.           help in tracking down the many bugs which were visible in earlier
  516.           Maximus releases, but also for their helpful suggestions and
  517.           comments.  My thanks also go to the rest of the documentation
  518.           team, as listed on the front page of each manual.
  519.  
  520.           Thanks go to the following people who have contributed to the
  521.           Maximus source, by donating algorithms, structures, ideas, or
  522.           even code.  (My sincere apologies if someone has been left out.)
  523.  
  524.           Peter Fitzsimmons
  525.           Vince Perriello and Bob Hartman
  526.           Andrew Farmer
  527.           Scott Friedman
  528.           Ray Duncan
  529.           Thomas Plum
  530.           Alan Hughes
  531.           Anders Brink
  532.           Jim Lin
  533.           Gordon Benedict
  534.  
  535.           Finally, I wish to acknowledge several products and trademarks
  536.           which have been mentioned in this document.  Use of these names
  537.           and trademarks neither constitutes an endorsement nor suggests
  538.           any affiliation with the specified products.
  539.  
  540.           ARC, SEAlink & SEAdog:        Thom Henderson
  541.  
  542.  
  543.                     Maximus 2.02 System Operations Manual - Page 7
  544.  
  545.  
  546.  
  547.           BinkleyTerm:                  Bob Hartman & Vince Perriello
  548.           BNUcomm:                      David Nugent, Unique Computing
  549.           Courier HST:                  U.S. Robotics Inc.
  550.           DESQview:                     Quarterdeck Office Systems
  551.           DoubleDOS:                    SoftLogic Solutions Inc.
  552.           FEND:                         David Luong
  553.           Fido & FidoNet:               Tom Jennings, Fido Software
  554.           FrontDoor & FDterm:           Joaquim Homrighausen
  555.           FView:                        Doug Boone
  556.           IBM-PC, PC-DOS, OS/2:         International Business Machines
  557.           Lharc and LZH:                Haruyasu Yoshizaki
  558.           MS-DOS:                       Microsoft Inc.
  559.           Opus-CBCS:                    Wynn Wagner III
  560.           OpusComm & ConfMail:          Bob Hartman, Spark Software
  561.           PCBoard:                      Clark Software Development Corp.
  562.           QuickBBS:                     Pegasus Software, Inc.
  563.           QM, QMail & AreaFix:          Greg Dawson & George Peace
  564.           RBBS:                         Capital PC Users Group
  565.           TBBS:                         eSoft, Inc.
  566.           Telix:                        Colin Sampaleanu, Exis Inc.
  567.           TheDraw:                      Ian Davis, TheSoft Services
  568.           TinyTerm, OECC:               George A. Stanislav
  569.           Turbo C:                      Borland International
  570.           V-Series and Hayes:           Hayes Microcomputer Products
  571.           VT-100:                       Digital Equipment Corporation
  572.           X00, SIO:                     Ray Gwinn
  573.           Xmodem:                       Ward Christiensen
  574.           ZIP:                          Phil Katz, PKWare
  575.           Zmodem and MobyTurbo:         Chuck Forsberg
  576.  
  577.  
  578.  
  579.  
  580.  
  581.  
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.                     Maximus 2.02 System Operations Manual - Page 8
  599.  
  600.  
  601.  
  602.                                  SYSTEM REQUIREMENTS
  603.  
  604.           Although it is possible to run Maximus on a system with less than
  605.           the following equipment, the following should be considered the
  606.           realistic minimum with which you can get by:
  607.  
  608.           For Maximus-DOS:
  609.  
  610.           *    An IBM (or compatible) personal computer running MS-DOS,
  611.                PC-DOS, with at least 256K of available RAM, with at least
  612.                164K free.
  613.  
  614.           *    MS-DOS or PC-DOS version 2.0 or greater, 3.2 or above
  615.                preferred.
  616.  
  617.           *    A FOSSIL communications driver, revision level 5 or higher. 
  618.                (Common FOSSILs are X00, BNU and OpusComm.)
  619.  
  620.           For Maximus-OS/2:
  621.  
  622.           *    An IBM (or compatible) personal computer running OS/2, with
  623.                at least four megabytes of RAM.
  624.  
  625.           *    IBM OS/2 version 1.2 or above
  626.  
  627.           For all versions of Maximus:
  628.  
  629.           *    A Hayes-compatible modem.  It is possible to use Maximus
  630.                with a modem which is not Hayes-compatible.  However, doing
  631.                so will make your life unnecessarily complicated.
  632.  
  633.           *    A hard disk.  A capacity of 30 megabytes or greater is
  634.                preferable.
  635.  
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.                     Maximus 2.02 System Operations Manual - Page 9
  654.  
  655.  
  656.  
  657.                                    MAXIMUS OVERVIEW
  658.  
  659.           This section of the documentation is designed to give you, the
  660.           SysOp, a general overview of what Maximus can do.  By any means,
  661.           this is not complete, but it should give you a general idea of
  662.           how the system operates.
  663.  
  664.  
  665.           Logging On
  666.  
  667.           When Maximus starts up with a caller on-line, the Maximus name
  668.           and version will be displayed, followed by the SysOp-created log-
  669.           on screen (usually \MAX\MISC\LOGO.BBS).  This screen should be
  670.           kept under 2K in length, and it should not use ANSI graphics and
  671.           high-bit IBM characters.
  672.  
  673.           After the logo screen has been displayed, Maximus will then
  674.           prompt the user to enter a name.  Unlike other BBS programs,
  675.           Maximus allows a user to use names with more than two words, so
  676.           even a name such as "Jesse David Hollington" will be accepted. 
  677.           (On the other hand, Maximus will reject callers with a one-word
  678.           name, unless you have the 'Alias System' keyword uncommented in
  679.           MAX.CTL.)
  680.  
  681.           However, if the user does NOT exist in the user file, Maximus
  682.           will display the NOTFOUND.BBS file.  This serves to confirm that
  683.           the user really wanted to enter the name which was entered at the
  684.           prompt.  In addition, Maximus will disable key stacking, just in
  685.           case the user entered a name in the format of 'Joe SysOp Y
  686.           Password', and misspelled the name 'Joe SysOp'.  With other BBS
  687.           software, this would result in a new user account being created
  688.           under the wrong name.
  689.  
  690.           If the name was not in the user file, Maximus will go through the
  691.           new user routine.  First, Maximus will display APPLIC.BBS; this
  692.           normally gives the caller some information about your system, and
  693.           it may also present an application form to be filled out.  (If a
  694.           caller hangs up before APPLIC.BBS has completed displaying, then
  695.           the user's configuration will NOT be saved, and no entry will be
  696.           made in USER.BBS.)
  697.  
  698.           When APPLIC.BBS ends, Maximus will then prompt the user to enter
  699.           his/her city, alias (if applicable), phone number, and so on. 
  700.           Finally, Maximus will display NEWUSER2.BBS, which can be yet
  701.           another screen directed toward educating new users.
  702.  
  703.           On the other hand, if the user's name was found in the user file,
  704.           then Maximus will ask that user to enter his/her password.  The
  705.           user will get five tries to enter the correct password; if all
  706.  
  707.  
  708.                    Maximus 2.02 System Operations Manual - Page 10
  709.  
  710.  
  711.  
  712.           five tries fail, or if the user pressed <enter> five times,
  713.           Maximus will hang up and recycle.  However, Max will display the
  714.           file \MAX\MISC\BAD_PWD.BBS before doing so, which means that you
  715.           can prompt the user to enter a message of explanation before
  716.           hanging up.
  717.  
  718.           If the user enters the correct password, Maximus will proceed
  719.           with the log-on sequence, and display WELCOME.BBS to the user. 
  720.           Note!  If a user's account has a BLANK password, then Maximus
  721.           will treat that user as a 'guest account'.  This means that
  722.           Maximus will ask a user who is using this account for his/her
  723.           configuration settings at every log-on, and Maximus will also
  724.           skip the password prompt.  This allows the SysOp to create an
  725.           account specifically for new users (while using a 'Logon Level
  726.           Preregistered' statement), such that users can look around the
  727.           system, but the user file will not get cluttered with users who
  728.           choose not to register.  (User registration would presumably be
  729.           done through an on-line questionnaire.)
  730.  
  731.           Maximus also supports a concept known as a 'custom welcome
  732.           screen'.  A special welcome screen can be created to display to
  733.           each individual user, BEFORE displaying the main WELCOME.BBS.  By
  734.           placing a file called '#.BBS' in the Maximus system directory,
  735.           where '#' is a user number, Maximus will display that .BBS file
  736.           to the caller with that user number.  (You can find out a user's
  737.           user number by looking in the log file, or also by doing a find
  738.           in the user editor.)  For example, if you wanted to show a custom
  739.           welcome to user #5, then you might create a file called
  740.           '\MAX\5.BBS'.
  741.  
  742.           As an added security feature, you can also disable remote sysop
  743.           logons.  If you place a "[isremote sequal hangup]" at the top of
  744.           your WELCOME.MEC, Max will automatically hang up on remote
  745.           callers with a priv level of SysOp.  If you never call your
  746.           system from remote, using this option can help prevent accidents.
  747.  
  748.           If the user has ANSI or AVATAR graphics support, the user can use
  749.           the cursor keys to edit any of the text on the command line. 
  750.           Editing can be performed through the <left>, <right>, <bs>,
  751.           <del>, <ctrl-left>, and <ctrl-right> keys.  To use this feature,
  752.           the caller's terminal must support either "Doorway mode" or VT-
  753.           100 keyboard codes.
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.                    Maximus 2.02 System Operations Manual - Page 11
  764.  
  765.  
  766.  
  767.           The Main Menu
  768.  
  769.           Although Max's menus are completely redefinable, this section
  770.           attempts to explain the commands which would normally be found on
  771.           the main menu.  This is also where the commands appear in the
  772.           default configuration.
  773.  
  774.           Message Section
  775.  
  776.                This enters the message section.  From here all the message
  777.                entering and reading features are available.  See the
  778.                section on the message areas for more detail.
  779.  
  780.           File Section
  781.  
  782.                This takes the user to the Files Section.  From here a user
  783.                can exchange files by uploading or downloading, or simply
  784.                see what files are available.  See the section on the file
  785.                areas for more detail.
  786.  
  787.           Change Setup
  788.  
  789.                This takes the user to the Change Setup menu.  From here, a
  790.                user can modify his/her user profile.  The user can set the
  791.                screen length, change the graphics mode, password, toggle
  792.                the full-screen editor, and more.  See the section on the
  793.                Change Setup menu for more details.
  794.  
  795.           Goodbye
  796.  
  797.                This option logs the user off the system and hangs up the
  798.                phone.  This is almost identical to what happens if a user
  799.                simply drops carrier.  Maximus will not 'hang' if a user
  800.                drops carrier, but will recycle as if they logged off using
  801.                this command.  This command simply asks the user to confirm
  802.                that they want to disconnect, asks if he/she wants to leave
  803.                a message to the sysop, and then hangs up on the user.  By
  804.                default, comments are placed in message area 1, although
  805.                this is selectable in MAX.CTL.
  806.  
  807.           Comments to the sysop are saved in the "Comment Area", as defined
  808.           in MAX.CTL.  (By default, comments are stored in area 1.)  If
  809.           message area 1 does not exist, or if you use a "Comment Area"
  810.           statement with no area listed, users will not be asked if they
  811.           want to leave you comments.
  812.  
  813.  
  814.  
  815.  
  816.  
  817.  
  818.                    Maximus 2.02 System Operations Manual - Page 12
  819.  
  820.  
  821.  
  822.           Statistics
  823.  
  824.                This option displays the user's statistics, including the
  825.                time the user has been online for the current call, the time
  826.                online for the day, amount uploaded, amount downloaded,
  827.                NetMail credit, and so on.
  828.  
  829.           Yell
  830.  
  831.                This command allows the user to attempt to contact the SysOp
  832.                while he/she is on-line.  You can set when you want users to
  833.                be able to page you with this command, and you can toggle
  834.                the local speaker noise with the local "!" command.
  835.  
  836.           Userlist
  837.  
  838.                This command simply displays a list of all the users who are
  839.                currently in the user file.  You can set the maximum and
  840.                minimum privilege levels to display in the list through
  841.                options in the control file.  By default, will not display
  842.                users with a privilege of SysOp, Hidden or Twit.  These
  843.                privilege levels are also selectable in the control file.
  844.  
  845.           Version
  846.  
  847.                This displays the version number and a few other statistics
  848.                about the current revision of Maximus and the version of the
  849.                operating system currently in use.
  850.  
  851.           SysOp Menu
  852.  
  853.                This command takes you to the Maximus SysOp menu.  See below
  854.                for more details.
  855.  
  856.           Chat Menu
  857.  
  858.                If enabled, this menu can be used to access all of Max's
  859.                multi-node chat features, including paging, toggling chat
  860.                availability, and the chat itself.  This feature allows
  861.                callers to talk with one or more other callers.  Chatting
  862.                with the SysOp is performed through the Yell command.
  863.  
  864.  
  865.  
  866.  
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.                    Maximus 2.02 System Operations Manual - Page 13
  874.  
  875.  
  876.  
  877.           Who is On?
  878.  
  879.                If the multi-node chat system is enabled, this command can
  880.                be used to display a list of callers who are currently
  881.                logged onto other nodes of the same system.  This command
  882.                will display the user name, the node number, and that user's
  883.                status.  The status message indicates the current activities
  884.                of the user, such as "Downloading a file", "Entering a
  885.                message", and so on.
  886.  
  887.           In addition, you can define other options in the main menu to
  888.           call sub-menus, display text files, or run external programs. 
  889.           See the control-file reference section for more details on
  890.           defining menus.
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.  
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.                    Maximus 2.02 System Operations Manual - Page 14
  929.  
  930.  
  931.  
  932.  
  933.           The Message Section
  934.  
  935.           There are four basic types of message areas within Maximus. 
  936.           These area types are Local, NetMail, EchoMail and conference
  937.           mail.
  938.  
  939.           Local messages are messages entered by a user on your BBS.  They
  940.           can be either public or private, and they remain on your BBS. 
  941.           Other users can only read these messages by logging onto your BBS
  942.           and selecting that particular message area.
  943.  
  944.           NetMail messages are messages that are sent from one BBS to
  945.           another through a network that you are connected to.  They are
  946.           generally private messages.
  947.  
  948.           Unless you are a host or hub, most NetMail messages you encounter
  949.           will either be entered on your system, or will be sent to your
  950.           system from another.  Maximus is fully compatible with the
  951.           FidoNet mail standard for these messages.  A user entering a
  952.           NetMail message will be prompted to enter additional information
  953.           to tell your mail processor where to send the message.  Maximus
  954.           is capable of reading a FidoNet compatible Version 5 or Version 6
  955.           nodelist file in order to get its address and cost information. 
  956.           Generally your users will need to have credit in their user
  957.           accounts in order to send NetMail.  Under most circumstances you
  958.           should only have one of these areas.
  959.  
  960.           EchoMail messages are messages that are shared between several
  961.           bulletin board systems over a wide area.  An EchoMail message
  962.           will be sent through your network to all other systems
  963.           participating in that same conference.  Generally, EchoMail areas
  964.           only permit public message.  To a Maximus user, an echo area
  965.           appears identical to a local message area, except that messages
  966.           entered in EchoMail areas will have special control information
  967.           added to the end, such as origin and tear lines.  In addition,
  968.           when a user enters a message in an EchoMail area, Maximus will
  969.           add that area's tag to your echo tosslog.
  970.  
  971.           Maximus also supports a variety of message area toggles (or
  972.           "attributes"), each of which can be set independently.  Although
  973.           a complete list can be found in the MSGAREA.CTL reference in the
  974.           Maximus Technical Reference Manual, some of the more common
  975.           attributes are:
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.                    Maximus 2.02 System Operations Manual - Page 15
  984.  
  985.  
  986.  
  987.           Private Only
  988.  
  989.                All messages entered in these areas will be marked private,
  990.                and can only be read by the user who sent the message, the
  991.                user it is addressed to, and the sysop.
  992.  
  993.           Public Only
  994.  
  995.                All messages entered in these areas will be public and can
  996.                be read by any user.  This flag is recommended for EchoMail
  997.                areas.
  998.  
  999.           Read-Only
  1000.  
  1001.                Messages in these areas can be read by users, but only users
  1002.                with a privilege level of assistant sysop or higher can
  1003.                enter messages.
  1004.  
  1005.           Anonymous OK
  1006.  
  1007.                If an area has this attribute set, users can optionally
  1008.                enter messages under a pseudonym instead of that user's real
  1009.                name.  Maximus will embed the user's real name within the
  1010.                message in such a way that only the SysOp can see it.  If
  1011.                this causes some sort of security or anonymity problem, this
  1012.                embedding of the user's real name can be disabled.  Please
  1013.                refer to the MSGAREA.CTL reference (in the Maximus Technical
  1014.                Reference Manual) for more details.
  1015.  
  1016.           Maximus is also capable of assigning passwords to message and
  1017.           file areas, and re-assigning privileges within the area for
  1018.           certain passwords.  In addition, you can assign user names to the
  1019.           barricade file, so only certain users can enter an area.  See the
  1020.           section on extended barricades in MAX_REF.DOC for more details.
  1021.  
  1022.           In addition, the private and public message-area attributes can
  1023.           be defined individually by privilege level, rather than globally
  1024.           for all callers.  (In other words, you can allow the SysOp to
  1025.           enter anonymous messages, while still forcing normal users to use
  1026.           their real names.) See the control-file reference for more
  1027.           information on how to assign these attributes to areas.
  1028.  
  1029.  
  1030.           The Message Menu
  1031.  
  1032.           The following attempts to explain the options that would normally
  1033.           be used in a message area menu:
  1034.  
  1035.  
  1036.  
  1037.  
  1038.                    Maximus 2.02 System Operations Manual - Page 16
  1039.  
  1040.  
  1041.  
  1042.           Area Change
  1043.  
  1044.                This command allows the user to change to another message
  1045.                area.  The user will be prompted to enter the message area
  1046.                they want to go to, or to enter a "?" for a list of the
  1047.                areas that are available to them.  The user can also enter
  1048.                the "<" or ">" characters to go to the previous or next area
  1049.                in the list, respectively.  If entering a barricaded area
  1050.                where a password is required, he/she will be prompted for
  1051.                the password before they are allowed to enter the area.
  1052.  
  1053.           Next
  1054.  
  1055.                This command will display the next message in the current
  1056.                area.  To keep reading messages in this direction, the user
  1057.                can press the ENTER key at the next prompt.  The ENTER key
  1058.                will repeat the last N)ext or P)revious command.
  1059.  
  1060.           Previous
  1061.  
  1062.                This command will display the previous message in the
  1063.                current area.  To keep reading messages in this direction,
  1064.                the user can press the ENTER key at the next prompt.  The
  1065.                ENTER key will repeat the last N)ext or P)revious command.
  1066.  
  1067.           Enter a Message
  1068.  
  1069.                This command will allow the user to enter a message.  After
  1070.                the user selects this command, Maximus will prompt them for
  1071.                some information is needs to know to send the message, such
  1072.                as who the message is to, the subject of the message, and
  1073.                whether the message is public or private, and any other
  1074.                information allowed by the configuration of the current
  1075.                area.
  1076.  
  1077.                If the area does not allow public messages, or does not
  1078.                allow private messages, the user will not be able to select
  1079.                whether they want the message to be public or private.
  1080.  
  1081.                If the area allows anonymous messages, the user will be able
  1082.                to change who the message is from as well.  If the message
  1083.                area is a NetMail area, the user will be prompted for a
  1084.                network address to send the message to.  When entering the
  1085.                address, the user can either enter the address, or use the
  1086.                following keys to get listings:
  1087.  
  1088.                     #    This will display a list of all the nodes in the
  1089.                          current net.
  1090.  
  1091.  
  1092.  
  1093.                    Maximus 2.02 System Operations Manual - Page 17
  1094.  
  1095.  
  1096.  
  1097.                     /    This will display a list of all the nets in the
  1098.                          nodelist.
  1099.  
  1100.                If you only enter a node number, Maximus will automatically
  1101.                default to your current net.
  1102.  
  1103.                A special shortcut exists for addressing points off the
  1104.                current system.  Suppose that you are currently entering a
  1105.                message on 1:106/114.  If you wish to write a message to
  1106.                John Doe at 1:106/114.22, simply enter '.22' at the
  1107.                destination prompt.  Maximus will automatically expand this
  1108.                address to the full '1:106/114.22'.
  1109.  
  1110.                After entering this information, the user will be placed in
  1111.                the message editor to enter the message.  For more details,
  1112.                refer to the section on message editors.
  1113.  
  1114.                Finally, if your nodelist processor can create a
  1115.                FIDOUSER.LST, Maximus is capable of finding a network
  1116.                address based on a user's name.  If you enable the "FidoUser
  1117.                D:\Path\Fidouser.Lst" statement in MAX.CTL, Max will search
  1118.                the nodelist for a particular SysOp name.  If that name was
  1119.                found, Max will automatically enter that SysOp's netmail
  1120.                address for you.
  1121.  
  1122.           Change a Message
  1123.  
  1124.                The Change command allows users to modify an existing
  1125.                message.  Before allowing a user to change a message, Max
  1126.                will check to make sure that the user actually WROTE that
  1127.                message.  Max will also check to see if the message has been
  1128.                scanned out or read by the recipient.  If either of these
  1129.                conditions is true, Max will display a message to that
  1130.                effect and abort the change.  (However, this acts only as a
  1131.                warning to callers with a priv level of SysOp; Max will
  1132.                always let the SysOp modify a message, whether or not the
  1133.                message has been read or scanned out.)
  1134.  
  1135.                Both the message header and the message body can be
  1136.                modified.  When graphics are turned on, the message status
  1137.                bits in the NetMail area (such as crash, hold, and so forth)
  1138.                can also be modified.
  1139.  
  1140.  
  1141.  
  1142.  
  1143.  
  1144.  
  1145.  
  1146.  
  1147.  
  1148.                    Maximus 2.02 System Operations Manual - Page 18
  1149.  
  1150.  
  1151.  
  1152.           Reply to Message
  1153.  
  1154.                This command allows the user to send a response to the
  1155.                author of the current message.  The reply command is similar
  1156.                to the enter command, except that some of the message fields
  1157.                will be filled in (the name of the author of the message to
  1158.                which you are replying will automatically be inserted in the
  1159.                To: field).  Also, once in the editor, the user will be able
  1160.                to QUOTE the message they are replying to.  See the section
  1161.                on the message editor for details.  "RK" [R)eply/K)ill] will
  1162.                kill the original message after the reply is finished.
  1163.  
  1164.           Read Non-Stop
  1165.  
  1166.                This command will allow a user to read all of the messages
  1167.                in the current area, starting with the current message,
  1168.                without pausing between each message.  This is useful if
  1169.                users want to capture the messages to a disk file for later
  1170.                perusal.
  1171.  
  1172.           Read Original
  1173.  
  1174.                This command will allow the user to display the original
  1175.                message to which the message they are reading is a reply. 
  1176.                Messages that are replies to another will have a "*** This
  1177.                is a reply to #xx" tag at the bottom of the message.
  1178.  
  1179.           Read Reply
  1180.  
  1181.                This command will allow the user to display any messages
  1182.                that are replies to the message they are reading.  Messages
  1183.                that have replies to them will have a "***See also #xx" tag
  1184.                at the bottom of them.
  1185.  
  1186.           Read Current
  1187.  
  1188.                This command will allow the user to redisplay the current
  1189.                message number.  This command is useful when first entering
  1190.                an area (to re-read the message you read in your last
  1191.                session), and also when trying to redisplay a message which
  1192.                scrolled off the screen.
  1193.  
  1194.  
  1195.  
  1196.  
  1197.  
  1198.  
  1199.  
  1200.  
  1201.  
  1202.  
  1203.                    Maximus 2.02 System Operations Manual - Page 19
  1204.  
  1205.  
  1206.  
  1207.           Browse
  1208.  
  1209.                Browse is an extremely powerful command; it replaces the
  1210.                functionality of Max 1.02's Scan, Inquire, List, and
  1211.                mailchecker commands.  Browse acts as a powerful database
  1212.                engine for the message bases.  Users can select a set of
  1213.                messages and operations to perform, and have Maximus
  1214.                automatically identify and display the messages which were
  1215.                requested.  Browse is broken down into 3-4 separate menus.
  1216.  
  1217.                The first menu allows the user to select a set of areas to
  1218.                query.  The user can select either the current area, the set
  1219.                of areas selected with the T)ag command, or all message
  1220.                area.
  1221.  
  1222.                The second menu allows the user to specify a set of messages
  1223.                to select.  The user can specify ALL MESSAGES (each message
  1224.                in every area specified), NEW MESSAGES (messages above the
  1225.                lastread pointer in each area), YOUR MESSAGES (messages
  1226.                above the lastread pointer and addressed to the current
  1227.                user), and FROM A MESSAGE NUMBER (such as from message #200
  1228.                and up).  Maximus also allows the user to perform a search
  1229.                based on keywords in the to, from and subject fields, in
  1230.                addition to the message body.  Complex searches can be
  1231.                defined using the logical OR and the logical AND operators.
  1232.  
  1233.                The third menu selects an operation to perform on the
  1234.                specified messages.  Selected messages can be listed (one to
  1235.                a line, to/from/subject only), read (displayed in full, with
  1236.                the option to reply or kill), or packed into a QWK bundle
  1237.                for off-line reading.
  1238.  
  1239.           Tag
  1240.  
  1241.                The tag command allows each user to select a subset of
  1242.                message areas available on the system.  Each individual user
  1243.                can select his or her own set of message areas to be stored
  1244.                across calls.  This set of areas can be used with the Browse
  1245.                command, or also with the Download command on the off-line
  1246.                reader menu.
  1247.  
  1248.           Edit User
  1249.  
  1250.                This function invokes the user editor from the message menu;
  1251.                however, it also reads in the current message, checks the
  1252.                'From:' field, and automatically positions the user editor
  1253.                on that user's user record.  This may be useful for
  1254.                validating users, since you can pull up a user's record at
  1255.                the press of a key.  (This command is for SysOps only.)
  1256.  
  1257.  
  1258.                    Maximus 2.02 System Operations Manual - Page 20
  1259.  
  1260.  
  1261.  
  1262.           Goodbye
  1263.  
  1264.                This is identical to the G)oodbye command at the main menu. 
  1265.                It will log off the user.
  1266.  
  1267.           Main Menu
  1268.  
  1269.                This will return the user to the main menu.
  1270.  
  1271.           Kill a Message
  1272.  
  1273.                This command allows a user to delete a message in the
  1274.                current area.  Unless a user has SysOp privileges, a user
  1275.                will only be able to kill messages which are addressed TO or
  1276.                FROM that individual.
  1277.  
  1278.           Upload a Message
  1279.  
  1280.                This command allows a user to directly upload a text file as
  1281.                a message to the current area.  This is identical to the
  1282.                E)nter message command, except instead of invoking the
  1283.                editor, Maximus will start a file upload.  The user may then
  1284.                upload a pre-typed ASCII text file which will be stored as a
  1285.                message.  Any file transfer protocol may be used for
  1286.                uploading the message text.  The maximum length of an
  1287.                uploaded message is 8K.
  1288.  
  1289.           Forward
  1290.  
  1291.                This command allows a user to make a copy of a message in
  1292.                the current area, and send it to someone else.  The user
  1293.                enters the message number to forward, and the name of the
  1294.                person to forward it to.  The user can also forward the
  1295.                message directly into another area by typing the area number
  1296.                when prompted.  The F)orward command supports two special
  1297.                modifiers, as follows:
  1298.  
  1299.                "FK" [F)orward K)ill] will delete the original message after
  1300.                forwarding it.
  1301.  
  1302.                "FB" [F)orward B)ombrun] will allow a user to specify a
  1303.                filename containing a list of users to forward the message
  1304.                to.  In order for a user to use this command,their privilege
  1305.                level must be equal to the privilege level required to
  1306.                create a message from a file as defined in the Maximus
  1307.                control file.  (See the control file reference in
  1308.                MAX_REF.DOC for more information.)  The format of the
  1309.                bombing run file is as follows:
  1310.  
  1311.  
  1312.  
  1313.                    Maximus 2.02 System Operations Manual - Page 21
  1314.  
  1315.  
  1316.  
  1317.                <username> <dest_net/dest_node> [-x]
  1318.  
  1319.                -x can be one of the following switches:
  1320.  
  1321.                     -h   Message should be marked as HOLD FOR PICKUP
  1322.                     -c   Message should be marked as CRASH
  1323.                     -n   Message should be marked as NORMAL (default)
  1324.  
  1325.                The bombing file can contain any number of lines.
  1326.  
  1327.                The <dest_net/dest_node> and [-x] fields are only used for
  1328.                NetMail messages, and should be omitted for local bombing
  1329.                runs.
  1330.  
  1331.                In the username field, spaces in a user's name must be
  1332.                represented by underscores.
  1333.  
  1334.                For example:
  1335.  
  1336.                SysOp                        225/337
  1337.                Scott_Dudley                 249/106      -c
  1338.                Hubert_Lai                   249/102      -h
  1339.                Vince_Perriello              141/191      -n
  1340.                Jesse_David_Hollington       225/1        -c
  1341.  
  1342.                This would send carbon copies of a message to the five
  1343.                people names, sending the messages to SysOp and Vince
  1344.                Perriello as NORMAL messages, and the messages to 249/106
  1345.                and 225/1 as CRASH messages.
  1346.  
  1347.                Note!  If you are performing a NetMail bombing run, make
  1348.                sure NOT to route your messages through anyone else. 
  1349.                Routing bombing-run messages is against FidoNet policy.
  1350.  
  1351.           Hurl
  1352.  
  1353.                This command is used to move messages from one area to
  1354.                another.  It will ask the user which message to hurl and
  1355.                which area to hurl it to.
  1356.  
  1357.                In addition, you can define other options in the message
  1358.                menu to call auxiliary menus, display text files, or run
  1359.                external programs.  See the control-file reference for more
  1360.                details on defining menus.
  1361.  
  1362.           Xport
  1363.  
  1364.                The Xport command, normally available only to SysOps, can be
  1365.                used to export a particular message to a specified filename. 
  1366.  
  1367.  
  1368.                    Maximus 2.02 System Operations Manual - Page 22
  1369.  
  1370.  
  1371.  
  1372.                This message will be formatted for 80 columns, and the file
  1373.                will also include the message header.  TO PRINT A MESSAGE ON
  1374.                THE PRINTER, specify an Xport filename of "prn".
  1375.  
  1376.           Message Entry
  1377.  
  1378.           For ANSI and AVATAR callers, Maximus supports a sophisticated
  1379.           message entry screen.  After selecting one of the options which
  1380.           begins the message entry process (such as E)nter, R)eply, or
  1381.           U)pload), Maximus will then display a "template" for the user to
  1382.           fill in.  The template indicates whether or not the message is
  1383.           private or public, the name of the recipient, the recipient's
  1384.           matrix address (if in a netmail area), the subject of the
  1385.           message, and optionally, an "alias" or alternate name for the
  1386.           sender.
  1387.  
  1388.           The user can move back and forth through the various items if
  1389.           they have an ANSI/VT-100 or IBM-compatible terminal emulator, and
  1390.           if not, users can also use the WordStar-like Control-E and
  1391.           Control-X keys to move up and down the fields (respectively). 
  1392.           Control-Y will delete the contents of the current field, and
  1393.           pressing <escape> TWICE will abort the message.  Assuming that
  1394.           all of the fields in the template have been filled, Maximus will
  1395.           invoke the message editor when the user presses <enter> on the
  1396.           last field in the header.
  1397.  
  1398.           Maximus also supports a carbon copy feature.  To utilize this,
  1399.           simply include your carbon copy list at the top of the message
  1400.           body in this form:
  1401.  
  1402.                cc: name1, name2, name3, etc.
  1403.  
  1404.           or this form:
  1405.  
  1406.                cc: name1
  1407.                cc: name2
  1408.                cc: name3
  1409.                cc: etc.
  1410.  
  1411.           If you are in the Matrix area, you may optionally specify a
  1412.           matrix address after each name.  However, Maximus will also look
  1413.           up the SysOp name in your FIDOUSER.LST and NAMES.MAX files; if a
  1414.           match can be found, the message will be automatically addressed
  1415.           to the right node.
  1416.  
  1417.  
  1418.  
  1419.  
  1420.  
  1421.  
  1422.  
  1423.                    Maximus 2.02 System Operations Manual - Page 23
  1424.  
  1425.  
  1426.  
  1427.           Message Editors
  1428.  
  1429.           Maximus supports two types of message editors:, MaxEd, the full
  1430.           screen editor, and BORED, the line-oriented editor.  Maximus also
  1431.           supports an external editor for local use, but that is covered in
  1432.           the control file documentation.
  1433.  
  1434.  
  1435.           MaxEd
  1436.  
  1437.           MaxEd is the Maximus full screen editor.  This can only be used
  1438.           by users who are capable of receiving ANSI or AVATAR graphics,
  1439.           and have a screen width of 80 columns and a length of at least 23
  1440.           rows.  The full screen editor has a number of advantages over the
  1441.           line editor, the most obvious being that it is far easier to use. 
  1442.           MaxEd is more like a word processor than a BBS editor; you can
  1443.           use the cursor keys to move around, insert and delete text in the
  1444.           middle of paragraphs, and so on.
  1445.  
  1446.           MaxEd uses a mixture of WordStar, generic VT-100 and IBM-PC
  1447.           commands, a list of which can be obtained by typing ^n
  1448.           (Control-N) from within the editor.  (The help file is contained
  1449.           in \MAX\HLP\FSED.MEC.)
  1450.  
  1451.           Also, if the message you are editing is a reply to another, then
  1452.           you can quote text from the original message, and place it inside
  1453.           your own, which greatly increases readability.  You can look at
  1454.           four lines at a time through a "quote window", and optionally
  1455.           copy those lines into the message you are writing.  You can also
  1456.           page through the original message in either direction, forward or
  1457.           backwards.
  1458.  
  1459.           MaxEd also has a special menu, which is accessible via either ^kH
  1460.           (Control-K and then 'H'). or the <F10> key The options available
  1461.           on the MaxEd menu are similar to those found on the BORED menu,
  1462.           and includes the following:
  1463.  
  1464.           Continue
  1465.  
  1466.                This will return to MaxEd and allow the user to continue
  1467.                entering the message.
  1468.  
  1469.  
  1470.  
  1471.  
  1472.  
  1473.  
  1474.  
  1475.  
  1476.  
  1477.  
  1478.                    Maximus 2.02 System Operations Manual - Page 24
  1479.  
  1480.  
  1481.  
  1482.           To
  1483.  
  1484.                This allows the user to change the addressee of the message.
  1485.  
  1486.           Subject
  1487.  
  1488.                This allows the user to change the subject of the message.
  1489.  
  1490.           From
  1491.  
  1492.                This will allow the user to change who the message is from. 
  1493.                The privilege level of this command should be set rather
  1494.                high, as this command can be used from any area, whether it
  1495.                is anonymous or not.
  1496.  
  1497.           Handling
  1498.  
  1499.                This is another command for which the privilege level should
  1500.                be set high.  It will allow the user to change the flags on
  1501.                the message.  Flags such as Private or Public can be
  1502.                changed, in addition to NetMail-type flags such as Crash,
  1503.                Hold or File Attach.
  1504.  
  1505.           Read File
  1506.  
  1507.                This will allow the user to enter a path to a file on your
  1508.                hard disk and read it in as a message.  The privilege level
  1509.                of this command should be set fairly high.
  1510.  
  1511.  
  1512.           BORED
  1513.  
  1514.           BORED is the Maximus line-editor.  BORED can be used by anybody,
  1515.           regardless of whether they have graphics or not.  Most users who
  1516.           have graphics will most likely prefer to use MaxEd.
  1517.  
  1518.           BORED allows the user to enter a message, one line at a time. 
  1519.           When the user is finished entering the message, they are
  1520.           presented with the editor menu.  The commands available on the
  1521.           editor menu are as follows:
  1522.  
  1523.           Save
  1524.  
  1525.                This will save the message the user has just entered.
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.                    Maximus 2.02 System Operations Manual - Page 25
  1534.  
  1535.  
  1536.  
  1537.           Abort
  1538.  
  1539.                This aborts the message without saving it.
  1540.  
  1541.           List
  1542.  
  1543.                Lists the message, preceding each line of the message with
  1544.                its line number.
  1545.  
  1546.           Edit
  1547.  
  1548.                This command edits a line in the message, to correct any
  1549.                mistakes.  Firstly, the user must select the line number
  1550.                that they wish to edit, then enter the text that they wish
  1551.                to replace, followed by the text you wish to replace it
  1552.                with.  To insert at the beginning of the line, just press
  1553.                <Enter> for the "Text to replace" prompt.
  1554.  
  1555.           Insert
  1556.  
  1557.                This command will insert a blank line in the message
  1558.                preceding a specified line number.
  1559.  
  1560.           Delete
  1561.  
  1562.                This command will delete a specified line of the message.
  1563.  
  1564.           Continue
  1565.  
  1566.                Allows the user to continue entering their message, by
  1567.                appending to the end.
  1568.  
  1569.           Quote
  1570.  
  1571.                This command allows the user to quote text from the message
  1572.                to which he/she is replying.  The user must enter the
  1573.                starting and ending numbers of the lines that he/she wishes
  1574.                to quote.
  1575.  
  1576.           To
  1577.  
  1578.                This allows the user to change the addressee of the message.
  1579.  
  1580.  
  1581.  
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.                    Maximus 2.02 System Operations Manual - Page 26
  1589.  
  1590.  
  1591.  
  1592.           Subject
  1593.  
  1594.                This allows the user to change the subject of the message.
  1595.  
  1596.           From
  1597.  
  1598.                This will allow the user to change who the message is from. 
  1599.                The privilege level of this command should be set rather
  1600.                high, as this command can be used in any message area,
  1601.                whether or not the area is declared as anonymous.
  1602.  
  1603.           Handling
  1604.  
  1605.                This is another command for which the privilege level should
  1606.                be set high.  It will allow the user to change the flags on
  1607.                the message.  Flags such as Private or Public can be
  1608.                changed, in addition to NetMail-type flags such as Crash,
  1609.                Hold or File Attach.
  1610.  
  1611.           Read File From Disk
  1612.  
  1613.                This will allow the user to enter a path to a file on your
  1614.                hard disk and read it in as a message.  The privilege level
  1615.                of this command should be set fairly high.
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.                    Maximus 2.02 System Operations Manual - Page 27
  1644.  
  1645.  
  1646.  
  1647.  
  1648.           The File Menu
  1649.  
  1650.           The following attempts to describe the options that would
  1651.           normally be used in a file area menu, and how they are displayed
  1652.           in the default configuration.
  1653.  
  1654.           Area Change
  1655.  
  1656.                This command allows the user to change to another file area. 
  1657.                The user will be prompted to enter the file area they want
  1658.                to go to, or to enter a "?" for a list of the areas that are
  1659.                available to them.  The user can also enter the "<" or ">"
  1660.                characters to go to the previous or next area in the list,
  1661.                respectively.  If entering a barricaded area where a
  1662.                password is required, they will be prompted for the password
  1663.                before they are allowed to enter the area.
  1664.  
  1665.           Locate
  1666.  
  1667.                This command allows a user to search all of the file areas
  1668.                accessible with his/her priv level.  The text that the user
  1669.                enters will be matched anywhere in the filename or
  1670.                description, so wildcards are not required.  There are a
  1671.                couple of modifiers to the L)ocate command.
  1672.  
  1673.                "L*" [L)ocate New] will search all of the file areas for any
  1674.                files that have been uploaded since the user was last on the
  1675.                system.
  1676.  
  1677.                "L?" [L)ocate ?)Help] will display help information on the
  1678.                L)ocate command.
  1679.  
  1680.           File Titles
  1681.  
  1682.                This command will display a list of files in the current
  1683.                area, along with their descriptions.  New files will be
  1684.                identified by a flashing asterisk (*).  An argument to this
  1685.                command can be specified in the same manner as for the
  1686.                L)ocate command, however F)ile Titles will only search the
  1687.                CURRENT file area.
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.                    Maximus 2.02 System Operations Manual - Page 28
  1699.  
  1700.  
  1701.  
  1702.           View
  1703.  
  1704.                This command will allow a user to display the contents of
  1705.                any ASCII text file.  The file is checked to make sure that
  1706.                it is an ASCII file, and the user is informed if it is not.
  1707.  
  1708.                NOTE!  In prior versions of Maximus, this command was called
  1709.                T)ype.
  1710.  
  1711.           Goodbye
  1712.  
  1713.                This is identical to the G)oodbye command at the main menu. 
  1714.                It will log the user off.
  1715.  
  1716.           Main Menu
  1717.  
  1718.                This will return the user to the main menu.
  1719.  
  1720.           Download
  1721.  
  1722.                The download command allows the user to download one or more
  1723.                files from the file areas.  Max 2.0 has a new format for
  1724.                downloading; now, users can enter the files to download on
  1725.                as many lines as they like, pressing <enter> after each
  1726.                file.  Wildcards will be automatically expanded.  If FB (the
  1727.                Maximus file database builder) is used, files can be quickly
  1728.                downloaded from any file area on the system, regardless of
  1729.                the current area.  (Of course, the user's priv level is
  1730.                checked before allowing such an operation.)  If files were
  1731.                T)agged earlier, those files will be automatically added to
  1732.                the current download.
  1733.  
  1734.                If no default protocol is selected, the user will also be
  1735.                prompted to select a file transfer protocol.  Maximus
  1736.                supports Xmodem, Xmodem-1k, SEAlink, Telink and Zmodem
  1737.                internally; more protocols, including DSZ, BiModem and Mpt,
  1738.                can be directly added as external protocols.
  1739.  
  1740.                The user can also specify one of several operations before
  1741.                beginning the transfer.  Entering "/q" causes Max to abort
  1742.                the transfer without sending anything.  Entering "/e" causes
  1743.                Max to revert to "edit mode"; this mode allows the user to
  1744.                delete and list files in the download queue.  Entering "/g"
  1745.                causes Max to hang up after the transfer is completed.
  1746.  
  1747.                To start the download, simply press <enter> on a blank line.
  1748.  
  1749.           Tag
  1750.  
  1751.  
  1752.  
  1753.                    Maximus 2.02 System Operations Manual - Page 29
  1754.  
  1755.  
  1756.  
  1757.                The Tag command allows the user to queue one or more files
  1758.                for later downloading.  The Tag command is also accessible
  1759.                through the "t" command (on the More [Y,n,t,=] prompt) when
  1760.                performing a F)iles listing or a L)ocate.
  1761.  
  1762.                Max will prompt the user to enter the filename to tag. 
  1763.                Wildcards are allowed, and if FB is used, global downloading
  1764.                is also permitted.  Max will NOT print a newline when
  1765.                tagging from a file listing to prevent the rest of the list
  1766.                from scrolling off the screen.
  1767.  
  1768.                To download previously-tagged files, simply select the
  1769.                Download option and press <enter> at the "File(s) to
  1770.                download" prompt.
  1771.  
  1772.           Upload
  1773.  
  1774.                This is the reverse of the download command, and allows a
  1775.                user to send files to your system.  Maximus will ask the
  1776.                user which protocol they are using to upload, and in some
  1777.                cases the name of the file they are uploading (if the user
  1778.                selects a batch protocol, such as Zmodem or SEAlink, the
  1779.                filename is transmitted automatically in the transfer, so
  1780.                Maximus will not bother prompting the user).  The protocols
  1781.                are identical to those used for the Download command.
  1782.  
  1783.           Statistics
  1784.  
  1785.                This option displays the user's statistics, including the
  1786.                time the user has been online for the current call, the time
  1787.                online for the day, amount uploaded, amount downloaded,
  1788.                NetMail credit (if any), and so on.
  1789.  
  1790.           Contents
  1791.  
  1792.                The C)ontents command will allow a user to look into a
  1793.                compressed file and see what files are contained inside. 
  1794.                The C)ontents can view any .ZIP, .ARC, .PAK, .ARJ or .LZH
  1795.                file.  For other compression methods, you are on your own.
  1796.  
  1797.           Raw Directory
  1798.  
  1799.                This will display a listing of ALL the files in the current
  1800.                file directory, not just the files listed in the files
  1801.                listing.  The privilege level of this command should be set
  1802.                fairly high.
  1803.  
  1804.  
  1805.  
  1806.  
  1807.  
  1808.                    Maximus 2.02 System Operations Manual - Page 30
  1809.  
  1810.  
  1811.  
  1812.           Override Path
  1813.  
  1814.                This will allow the user to supply a path to a different
  1815.                directory than the one specified in the FILEAREA.CTL file
  1816.                for the current file area.  This command should, for obvious
  1817.                reasons, be accessible only to users with high privilege
  1818.                levels.  All changes made with this command are temporary,
  1819.                and the area's path will revert back to normal once you
  1820.                leave the area.
  1821.  
  1822.           Hurl
  1823.  
  1824.                This command will allow a user to move a file from one area
  1825.                to another.  It will ask the user the name of the file to
  1826.                move, and the number of the file area to hurl it to.  This
  1827.                command should be set to a rather high privilege level.
  1828.  
  1829.           Kill File
  1830.  
  1831.                This command will allow the user to delete a file from a
  1832.                file area.  They will be asked for the name of the file to
  1833.                kill, and will then be asked to confirm that they want to
  1834.                delete it.  If they answer "n" to the "Delete?" prompt, they
  1835.                will be given the option of leaving the file but simply
  1836.                removing the entry from the file listing.  For obvious
  1837.                reasons, this command should be set to a high privilege
  1838.                level.
  1839.  
  1840.                In addition, you can define other options in the file menu
  1841.                to call auxiliary menus, display text files, or run external
  1842.                programs.  See the SILT Documentation for more details on
  1843.                defining menus.
  1844.  
  1845.  
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.  
  1854.  
  1855.  
  1856.  
  1857.  
  1858.  
  1859.  
  1860.  
  1861.  
  1862.  
  1863.                    Maximus 2.02 System Operations Manual - Page 31
  1864.  
  1865.  
  1866.  
  1867.  
  1868.           The Change Setup Menu
  1869.  
  1870.           From this section, a user may change as many of their settings as
  1871.           you permit.  Upon entering the change menu, the user's profile
  1872.           will be displayed.  The menu options are as follows:
  1873.  
  1874.           City
  1875.  
  1876.                Allows the user to change his/her city.
  1877.  
  1878.           Phone Number
  1879.  
  1880.                Allows the user to change his/her phone number.
  1881.  
  1882.           Real Name
  1883.  
  1884.                Designed for an alias system.  Allows user to change his/her
  1885.                real name.
  1886.  
  1887.           Password
  1888.  
  1889.                Allows the user to change their password.  The user will be
  1890.                prompted to enter his/her old password, then enter his/her
  1891.                new password twice.  If the user gets his/her old password
  1892.                wrong five times, he/she will be quietly disconnected.  If
  1893.                the new passwords do not match, the password will not be
  1894.                changed.  Users should be encouraged to change their
  1895.                passwords every so often to prevent other people from
  1896.                finding them out.
  1897.  
  1898.           Help Level
  1899.  
  1900.                Allows the user to change his/her help level.  There are
  1901.                four different help levels available in Maximus:
  1902.  
  1903.                     NOVICE:        Full Menus
  1904.                     REGULAR:       Abbreviated Menus
  1905.                     EXPERT:        No Menus
  1906.                     HOTFLASH:      Full-screen, hotkey interface
  1907.  
  1908.           Nulls
  1909.  
  1910.                Allows the user to change the delay after each transmitted
  1911.                line.  Most users will not need to use this unless they are
  1912.                using a really ancient terminal.
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.                    Maximus 2.02 System Operations Manual - Page 32
  1919.  
  1920.  
  1921.  
  1922.           Width
  1923.  
  1924.                Allows the user to change the width of his/her screen.  The
  1925.                screen width is used to determine where Maximus should
  1926.                word-wrap, and how wide the menus should be,among other
  1927.                things.
  1928.  
  1929.           Length
  1930.  
  1931.                Allows the user to change the length of his/her screen.  The
  1932.                screen length is used to determine when the "More?" prompts
  1933.                appear.
  1934.  
  1935.           Tabs
  1936.  
  1937.                Allows the user to toggle the translation of tabs.  Normally
  1938.                tabs are sent unaltered, which speeds up the display time
  1939.                marginally.  If this option is off, tabs will be translated
  1940.                to spaces before being sent.
  1941.  
  1942.           More
  1943.  
  1944.                This allows the user to toggle the 'More [Y,n,=]?' prompts
  1945.                on and off.
  1946.  
  1947.           Video Mode
  1948.  
  1949.                This allows the user to change video modes.  Currently, only
  1950.                TTY (plain), ANSI and AVATAR video modes are supported. 
  1951.                More video modes will be added in future releases of Maximus
  1952.                for compatibility with other systems.
  1953.  
  1954.           Full-Screen Editor
  1955.  
  1956.                This command allows users to toggle the use of the MaxEd
  1957.                full-screen editor.  If MaxEd is turned off, BORED will be
  1958.                turned on by default.
  1959.  
  1960.           Screen Clear
  1961.  
  1962.                This allows the user to toggle the sending of screen
  1963.                clearing codes in case his/her terminal cannot handle the
  1964.                TTY clearscreen (ASCII character 12) or the ANSI 'CLS'
  1965.                command.
  1966.  
  1967.  
  1968.  
  1969.  
  1970.  
  1971.  
  1972.  
  1973.                    Maximus 2.02 System Operations Manual - Page 33
  1974.  
  1975.  
  1976.  
  1977.           IBM Graphics
  1978.  
  1979.                This allows the user to toggle whether or not Maximus will
  1980.                send IBM extended ASCII characters.  The IBM (and
  1981.                compatibles) have a special 'extended' 8-bit character set,
  1982.                which allows things such as box-drawing and block graphics,
  1983.                while running in text mode.  Most non-IBM systems do not
  1984.                support these extended ASCII characters.  For those users
  1985.                that have this option turned off, Maximus will translate IBM
  1986.                extended ASCII characters into standard ASCII characters in
  1987.                the range of 32 (decimal) to 128.
  1988.  
  1989.           Hotkeys
  1990.  
  1991.                This option allows the user to turn the hotkeys setting on
  1992.                and off.  Turning on hotkeys instructs Maximus to execute
  1993.                commands as soon as they are received, without requiring an
  1994.                <enter> after every second keystroke.
  1995.  
  1996.           Language
  1997.  
  1998.                The Language command allows the user to select an alternate
  1999.                system language.  Max supports up to eight different
  2000.                language files, all of which can be available at the same
  2001.                time.  Simply add the appropriate "Language" statements to
  2002.                LANGUAGE.CTL, and those languages will become available for
  2003.                the Language command.  The user's language preference is
  2004.                automatically saved across calls; to prompt users for an
  2005.                alternate language every time they log on, place a
  2006.                "[menu_cmd chg_language]" token at the top of WELCOME.BBS.
  2007.  
  2008.           Protocol
  2009.  
  2010.                The Protocol command allows the user to select a default
  2011.                transfer protocol.  If a default file transfer protocol is
  2012.                selected, the Download command will immediately shift to the
  2013.                "File(s) to download" prompt instead of asking the user to
  2014.                choose a protocol.
  2015.  
  2016.           Archiver
  2017.  
  2018.                The Archiver command allows the user to select a default
  2019.                archiving and compression program.  Max will shell out to
  2020.                the archiver when performing certain functions, such as
  2021.                compressing QWK bundles and decompressing REP packets.  Max
  2022.                will use the information defined in COMPRESS.CFG to display
  2023.                a list of supported archivers, and will then prompt the user
  2024.                to choose one of the selected options.  (See the READER.CTL
  2025.  
  2026.  
  2027.  
  2028.                    Maximus 2.02 System Operations Manual - Page 34
  2029.  
  2030.  
  2031.  
  2032.                section in the Maximus Technical Reference Manual for more
  2033.                information.)
  2034.  
  2035.           Show in Userlist
  2036.  
  2037.                The Show in Userlist option allows each individual user to
  2038.                select whether or not his/her name should be displayed in
  2039.                the system userlog.  By default, the user's name will be
  2040.                displayed.  If you wish to stop users from using this
  2041.                command, simply change the priv level of the Chg_Userlist
  2042.                command to Hidden.
  2043.  
  2044.           Full-screen Reader
  2045.  
  2046.                The Full-Screen Reader option allows users to toggle between
  2047.                the old-style Max 1.0x message header (the default) and the
  2048.                Max 2.0 full-screen reader box.  The full-screen reader
  2049.                (hereafter referred to as FSR) displays a pretty blue box at
  2050.                the top of the screen, including the to/from/subject fields,
  2051.                reply links, and net/node information.  However, this box
  2052.                takes a bit longer to display on a remote system, so it is
  2053.                turned off by default.
  2054.  
  2055.           Alias
  2056.  
  2057.                The Alias command allows each user to select an alternate
  2058.                alias.  (Note:  by default, this command is disabled in the
  2059.                distribution MENUS.CTL.)  This command will change the
  2060.                "alias" field in the user record to whatever the user
  2061.                desires, as long as the specified alias does not already
  2062.                exist on the system.
  2063.  
  2064.           Quit
  2065.  
  2066.                This will return the user to the main menu.
  2067.  
  2068.           Due to the dynamic menu structure of Maximus, it is possible to
  2069.           configure the change menu to include any commands.  The above are
  2070.           only the commands that are most often used in the change menu on
  2071.           most systems.
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.  
  2083.                    Maximus 2.02 System Operations Manual - Page 35
  2084.  
  2085.  
  2086.  
  2087.  
  2088.           The SysOp Menu
  2089.  
  2090.           User Editor
  2091.  
  2092.                This invokes the Maximus Internal User Editor.  This command
  2093.                should be made available only to SysOps, for obvious
  2094.                reasons. See the section on the user editor for more
  2095.                details.
  2096.  
  2097.           OS Shell
  2098.  
  2099.                The OS shell permits either a local or remote shell to the
  2100.                operating system.  Note that <Alt-J> can always be used for
  2101.                a local shell to the OS.  (Note:  OS/2 users should use
  2102.                MaxPipe to run CMD.EXE, as opposed to redirecting
  2103.                COMMAND.COM.)
  2104.  
  2105.                If you are using an alternate command processor under DOS
  2106.                (such as 4DOS), make sure to change the menu entry for this
  2107.                command to reflect the command processor (ie. 4DOS.COM)
  2108.                instead of COMMAND.COM.
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.  
  2117.  
  2118.  
  2119.  
  2120.  
  2121.  
  2122.  
  2123.  
  2124.  
  2125.  
  2126.  
  2127.  
  2128.  
  2129.  
  2130.  
  2131.  
  2132.  
  2133.  
  2134.  
  2135.  
  2136.  
  2137.  
  2138.                    Maximus 2.02 System Operations Manual - Page 36
  2139.  
  2140.  
  2141.  
  2142.  
  2143.           The Chat Menu
  2144.  
  2145.           Maximus supports a full-fledged, internal multi-node chat module. 
  2146.           Users on different nodes can hold private discussions with one
  2147.           another; users can even engage in large group discussions on a
  2148.           "virtual CB channel".
  2149.  
  2150.           CB Chat
  2151.  
  2152.                The CB Chat function allows two or more users to participate
  2153.                in a real-time multi-node chat.  Messages can be sent back
  2154.                and forth, one line at a time, to all users who are
  2155.                participating in that particular conference channel. 
  2156.                (Maximus supports up to 255 virtual CB channels.)
  2157.  
  2158.           Page User
  2159.  
  2160.                The Page User command allows for private chatting between
  2161.                two nodes only.  Selecting Page causes Maximus to send a
  2162.                "chat request" to the specified node number, and it will
  2163.                automatically place the paging user in chat mode, waiting
  2164.                for the other user to respond to the page.
  2165.  
  2166.           Answer Page
  2167.  
  2168.                The Answer Page command is used in conjunction with the Page
  2169.                User command; after a user receives a page message from
  2170.                another user, the paged user can select Answer Page to
  2171.                engage in a private chat with the first user.
  2172.  
  2173.           Toggle Status
  2174.  
  2175.                The Toggle Status function allows a user to toggle his/her
  2176.                chat availability.  Users which are unavailable for chat
  2177.                will be unpagable through the Page User command.
  2178.  
  2179.  
  2180.  
  2181.  
  2182.  
  2183.  
  2184.  
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.                    Maximus 2.02 System Operations Manual - Page 37
  2194.  
  2195.  
  2196.  
  2197.  
  2198.           The Off-Line Reader Menu
  2199.  
  2200.           The Off-Line Reader menu is the key to Max's internal QWK mail
  2201.           packer.  This menu can be used to select a default protocol and
  2202.           archiving program, select a set of message areas, download
  2203.           messages from those areas, and upload reply packets.
  2204.  
  2205.           Tag Area
  2206.  
  2207.                The Tag Area command (equivalent to the command of the same
  2208.                name on the message menu) allows the user to select a set of
  2209.                message areas for access with the Browse or Download
  2210.                commands.  This area selection will be saved across calls,
  2211.                so it is possible to select a set of message areas that
  2212.                interest the user and keep referring to those tagged areas
  2213.                for future calls.
  2214.  
  2215.           Download New Msgs
  2216.  
  2217.                The Download command packs new messages from all of the
  2218.                currently-tagged areas, compresses them into an archive, and
  2219.                prepares the file for download.  (This option is the
  2220.                equivalent of specifying the argument "t;n;p" for the Browse
  2221.                command.)  If no default archiver or protocol is selected,
  2222.                Max will prompt the user to select a protocol before
  2223.                commencing the download.
  2224.  
  2225.           Upload Replies
  2226.  
  2227.                The Upload Replies option allows users to upload a .REP
  2228.                reply packet into the message areas.  Max will automatically
  2229.                determine the type of archive (even if it is different from
  2230.                the one selected as the user's default archiver), decompress
  2231.                the reply packet, and toss the replies into the appropriate
  2232.                areas.
  2233.  
  2234.           Protocol Default
  2235.  
  2236.                The Protocol option allows the user to select a default file
  2237.                transfer protocol; this option is identical to the one found
  2238.                on the Change menu,
  2239.  
  2240.  
  2241.  
  2242.  
  2243.  
  2244.  
  2245.  
  2246.  
  2247.  
  2248.                    Maximus 2.02 System Operations Manual - Page 38
  2249.  
  2250.  
  2251.  
  2252.           Archiver Default
  2253.  
  2254.                The Archiver option allows the user to select a default
  2255.                archiving program; this option is identical to the one found
  2256.                on the Change menu.
  2257.  
  2258.  
  2259.  
  2260.  
  2261.  
  2262.  
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.  
  2269.  
  2270.  
  2271.  
  2272.  
  2273.  
  2274.  
  2275.  
  2276.  
  2277.  
  2278.  
  2279.  
  2280.  
  2281.  
  2282.  
  2283.  
  2284.  
  2285.  
  2286.  
  2287.  
  2288.  
  2289.  
  2290.  
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.                    Maximus 2.02 System Operations Manual - Page 39
  2304.  
  2305.  
  2306.  
  2307.                               INSTALLATION INSTRUCTIONS
  2308.  
  2309.           This section of the manual describes how to install Maximus from
  2310.           scratch.  There is no conversion procedure available for other
  2311.           BBS programs aside from CVTUSR, the Maximus user file conversion
  2312.           utility.
  2313.  
  2314.           Users of Maximus/2 should also read OS2.DOC before beginning the
  2315.           installation.
  2316.  
  2317.  
  2318.           Step 1:   Where do I put these files?
  2319.  
  2320.           This is the easiest part of installing Maximus.  Max is
  2321.           distributed in four separate parts:  MAX202R.LZH, MAX202P.LZH,
  2322.           and MAX202C.LZH.
  2323.  
  2324.           MAX202R.LZH contains DOS (real-mode) executables.
  2325.           MAX202P.LZH contains OS/2 (protected-mode) executables.
  2326.           MAX202C.LZH contains common executables for both DOS and OS/2.
  2327.  
  2328.           To install Maximus, you will need MAX202C.LZH, plus either or
  2329.           both of MAX202R.LZH or MAX202P.LZH.  The install program will
  2330.           examine the files that are available, and if both the DOS and
  2331.           OS/2 versions of the executables are present, it will allow you
  2332.           to select either or both versions for installation.
  2333.  
  2334.           The first step in the installation is to unarchive all four files
  2335.           into an empty subdirectory using LHarc.  (Obviously, since you
  2336.           are reading this file, you already know how to operate LHarc!)
  2337.  
  2338.           Most of the files in the distribution kit are packed using a
  2339.           proprietary FIZ compression method, so you'll see a few files
  2340.           with a .FIZ extension, some documentation files, and the install
  2341.           program itself.  The only way to unpack the .FIZ files is through
  2342.           the installation program, so that's what you should run next.
  2343.  
  2344.           When run, the installation program will display some copyright
  2345.           information, and then proceed with the installation.  It will ask
  2346.           you where to place the contents of each .FIZ file; unless you
  2347.           know what you are doing, or if want to use a different directory
  2348.           structure, the defaults are recommended.  To select the default
  2349.           path, simply press <enter> at each prompt.  (The installation
  2350.           program will create directories which do not exist.)
  2351.  
  2352.           You should make sure to specify that you are performing a NEW
  2353.           installation (the default), since you need to extract ALL of the
  2354.           Max 2.02 files.
  2355.  
  2356.  
  2357.  
  2358.                    Maximus 2.02 System Operations Manual - Page 40
  2359.  
  2360.  
  2361.  
  2362.           After extracting each .FIZ file, the installation program will
  2363.           then proceed with the first-time configuration.  Simply type in
  2364.           the appropriate text at each box, and use <tab> (or click with
  2365.           the mouse) to move between fields.  To select a particular option
  2366.           from a radio button group, use the left/right keys to cursor over
  2367.           to the appropriate location and press <space> to select that
  2368.           option.  Click or press <enter> on the OK button when you have
  2369.           specified the correct values.
  2370.  
  2371.  
  2372.           Warning for OS/2 users!
  2373.  
  2374.           Most of the executables in the OS/2 version of Maximus end with
  2375.           the letter "p".  This "p" signifies that they are protected-mode
  2376.           executables and can be run under OS/2.  While the extra "p" is
  2377.           not necessary, it allows both Max-DOS and Max-OS/2 to be
  2378.           installed into the same directory.
  2379.  
  2380.           To keep the documentation concise, whenever an executable name is
  2381.           discussed, only the base name (without the "p") is mentioned. 
  2382.           When working through the installation, keep in mind that when the
  2383.           documentation refers to an executable filename, a "p" should be
  2384.           added for OS/2 users.
  2385.  
  2386.           For example, while the DOS version of the "ANS2BBS" utility is
  2387.           ANS2BBS.EXE, the OS/2 version is instead called ANS2BBSP.EXE.
  2388.  
  2389.  
  2390.  
  2391.  
  2392.  
  2393.  
  2394.  
  2395.  
  2396.  
  2397.  
  2398.  
  2399.  
  2400.  
  2401.  
  2402.  
  2403.  
  2404.  
  2405.  
  2406.  
  2407.  
  2408.  
  2409.  
  2410.  
  2411.  
  2412.  
  2413.                    Maximus 2.02 System Operations Manual - Page 41
  2414.  
  2415.  
  2416.  
  2417.  
  2418.           Step 2:   Configuring your Modem
  2419.  
  2420.           The modem is your gateway to the rest of the world.  It can also
  2421.           be your biggest headache.  Since this documentation cannot cover
  2422.           all aspects of installing your modem, you should refer to your
  2423.           modem's manual if you are experiencing difficulties.
  2424.  
  2425.           To begin with, a Hayes-compatible modem is strongly recommended. 
  2426.           Although you may be able to use Maximus with a non-Hayes-
  2427.           compatible modem, Maximus will be unable to use your modem to its
  2428.           full potential.
  2429.  
  2430.           If you do have a Hayes-compatible modem, but you cannot get it to
  2431.           work, chances are that are that your problems have to do with
  2432.           DCD, or Data Carrier Detect.  DCD is a signal which your modem
  2433.           sends to your computer when it is connected to another modem. 
  2434.           However, when most modems are shipped from the factory, they have
  2435.           DCD forced on all the time.  Unfortunately, this default is
  2436.           exactly the opposite of what most bulletin board packages
  2437.           require, including Maximus.  Without DCD set correctly, Maximus
  2438.           will not be able to tell when a user has hung up, and your mailer
  2439.           software may have problems handling incoming phone calls.  There
  2440.           are two ways to change the way your modem handles DCD, depending
  2441.           on the type of modem you have.
  2442.  
  2443.           If you own a 1200 bps modem, then chances are that your modem's
  2444.           DCD handling is controlled through DIP switches.  DIP switches
  2445.           are those miniscule plastic bits on the front, rear or bottom of
  2446.           your modem.  (You may have to remove one or more panels to access
  2447.           these switches.)  On most 1200 bps modems, DIP switch #6 toggles
  2448.           whether or not DCD is forced, and it should usually be set in the
  2449.           UP position.  (However, it is a good idea to check your modem
  2450.           manual, just in case the switch settings are different.)  Set the
  2451.           switch so that DCD reflects the modem's actual state, instead of
  2452.           being forced on.  Also make sure that your modem will send back
  2453.           verbal result codes (as opposed to numbers).  The DIP switch to
  2454.           control these result codes varies by modem manufacturer, so you
  2455.           will need to consult your modem's manual to determine which one
  2456.           to use.
  2457.  
  2458.           If you own a 2400 bps (or greater) modem, then you will be spared
  2459.           the trouble of fiddling with DIP switches.  Since almost all of
  2460.           these modems use non-volatile RAM (or NVRAM) instead of DIP
  2461.           switches, you can modify the modem's settings directly using a
  2462.           terminal program.  Once you load up a communications package,
  2463.           type in the command 'AT' and press <enter>.  If everything is
  2464.           well, your modem should emit a response of "OK".  After you have
  2465.           established that your modem is working, type in the command
  2466.  
  2467.  
  2468.                    Maximus 2.02 System Operations Manual - Page 42
  2469.  
  2470.  
  2471.  
  2472.           'AT&C1&S1&D2&W' and press <enter>.  (This command may not work
  2473.           for all 2400 bps modems; consult your modem manual for details.) 
  2474.           This command will set up your modem so that DCD will always
  2475.           reflect the modem's actual state, rather than being always forced
  2476.           high.
  2477.  
  2478.           One other thing which may caused problems is your modem cable. 
  2479.           If your cable does not have the right number of signals wired
  2480.           through, your modem may also behave as if DCD was set
  2481.           incorrectly, regardless of DIP switch or NVRAM settings.  One way
  2482.           you can verify your cable configuration is by borrowing a modem
  2483.           cable from a fellow SysOp.  If you determine that your cable is
  2484.           at fault, you can go to your local computer store or service
  2485.           centre, and ask them for a cable that has at least pins 2-8 and
  2486.           20 wired straight through.
  2487.  
  2488.  
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.  
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.  
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.  
  2516.  
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.                    Maximus 2.02 System Operations Manual - Page 43
  2524.  
  2525.  
  2526.  
  2527.  
  2528.           Step 3:   Installing a communications driver
  2529.  
  2530.  
  2531.           OS/2 users:
  2532.  
  2533.                Note!  Unlike DOS, OS/2 does not require a FOSSIL driver. 
  2534.                OS/2 includes its own device driver to handle serial I/O. 
  2535.                Unfortunately, the device driver included with OS/2 does not
  2536.                work correctly in all situations:
  2537.  
  2538.                -    For OS/2 1.x, the supplied COM0x.SYS driver has a
  2539.                     tendency to "lose" com ports after running for a number
  2540.                     of hours.
  2541.  
  2542.                -    For OS/2 2.x, the supplied COM.SYS driver sometimes
  2543.                     uninstalls itself after certain communication errors
  2544.                     occur.
  2545.  
  2546.                Fortunately, a number of third-party device drivers are
  2547.                available:
  2548.  
  2549.                Under OS/2 1.x, the COM16550.SYS drivers can be used instead
  2550.                of the stock COM0x.SYS drivers.  The COM16550 drivers are
  2551.                included in the Maximus distribution.  See the documentation
  2552.                in \MAX\COM16550.LZH for more information.
  2553.  
  2554.                Under OS/2 2.x, two options are available.  The COM16550
  2555.                drivers can still be used, but a third-party driver called
  2556.                SIO.SYS (which is specific to OS/2 2.x) has many more
  2557.                features.
  2558.  
  2559.                SIO.SYS is not provided with Maximus, but it can be obtained
  2560.                from the Hobbes OS/2 archive at ftp.cdrom.com, and also from
  2561.                most BBSes that offer OS/2 support.
  2562.  
  2563.                Note that COM16550 has a maximum speed of 19.2kbps, whereas
  2564.                SIO.SYS has a maximum speed of 57.6kbps.  For this reason,
  2565.                if you are running a V.34 modem, SIO.SYS is preferable to
  2566.                COM16550.
  2567.  
  2568.           DOS users:
  2569.  
  2570.                Under DOS, Maximus uses an external serial port driver. 
  2571.                Like most FidoNet-compatible packages, Maximus requires a
  2572.                FOSSIL.  'FOSSIL' is an acronym which stands for
  2573.                'Fido/Opus/SEAdog Standard Interface Layer'.  A FOSSIL is a
  2574.                program which handles all of Maximus' low-level serial
  2575.  
  2576.  
  2577.  
  2578.                    Maximus 2.02 System Operations Manual - Page 44
  2579.  
  2580.  
  2581.  
  2582.                communication needs, including sending and receiving
  2583.                characters.
  2584.  
  2585.                Using a FOSSIL allows Maximus to be used on semi-compatible
  2586.                computer systems which do not have 100% compatible serial
  2587.                hardware.  The Maximus distribution package is shipped with
  2588.                a copy of David Nugent's BNU FOSSIL, which will be more than
  2589.                enough to get your system running.  However, if BNU is not
  2590.                suitable or will not run on your system, other FOSSILs are
  2591.                available.  Some of the most common FOSSILs are X00 and
  2592.                OpusComm.  (Later versions of BNU may also be available.)
  2593.  
  2594.                If you cannot find any of these programs on a BBS near you,
  2595.                one can be usually be obtained from a local Software
  2596.                Distribution System ("SDS") node, or from the author's BBS. 
  2597.                (See the program licence for details on the author's BBS.)
  2598.  
  2599.                When you are searching for a FOSSIL driver, make sure that
  2600.                the FOSSIL supports at least "FOSSIL Revision 5" or above,
  2601.                since Maximus will not work with lower FOSSIL versions.
  2602.  
  2603.                There are two principal techniques used to install a FOSSIL. 
  2604.                Some FOSSILs, such as OpusComm and BNU, are loaded as TSR
  2605.                (Terminate and Stay Resident) programs in your AUTOEXEC.BAT
  2606.                file.  Others, such as X00.SYS, are loaded via your
  2607.                CONFIG.SYS file.  Although different FOSSILs have different
  2608.                set-up instructions, it is fairly easy to install a FOSSIL
  2609.                for a basic configuration.
  2610.  
  2611.                Here are the basic installation instructions for the three
  2612.                most popular FOSSILs.  These cover only a generic 2400 bps
  2613.                modem on COM1; you should consult your FOSSIL manual to use
  2614.                Max on a different COM port or at higher speeds.
  2615.  
  2616.                OPUSCOMM Installation:
  2617.  
  2618.                     To install OpusComm on COM1, simply insert the
  2619.                     following command at the beginning of your
  2620.                     AUTOEXEC.BAT:
  2621.  
  2622.                     OPUSCOMM
  2623.  
  2624.                     Make sure that OPUSCOMM.EXE is on your current PATH, or
  2625.                     else this will not work.
  2626.  
  2627.  
  2628.  
  2629.  
  2630.  
  2631.  
  2632.  
  2633.                    Maximus 2.02 System Operations Manual - Page 45
  2634.  
  2635.  
  2636.  
  2637.                BNUCOM Installation:
  2638.  
  2639.                     To install BNUcom on COM1, simply insert the following
  2640.                     command at the beginning of your AUTOEXEC.BAT:
  2641.  
  2642.                     BNU
  2643.  
  2644.                     Make sure that BNU.COM is on your current PATH, or else
  2645.                     this will not work.
  2646.  
  2647.                X00 Installation:
  2648.  
  2649.                     To install X00 on COM1:, simply insert the following
  2650.                     command at the beginning of your CONFIG.SYS:
  2651.  
  2652.                     DEVICE=X00.SYS
  2653.  
  2654.                     Make sure that X00.SYS is in your C:\ root directory,
  2655.                     or else this will not work.
  2656.  
  2657.           Checklist for high-speed modems
  2658.  
  2659.           When running at high speeds, most modems communicate with your
  2660.           computer and the remote modem at different speeds.  For this
  2661.           reason, if you are running a high-speed modem, you must instruct
  2662.           Maximus to talk to the modem at a fixed speed.
  2663.  
  2664.           To use a fixed port speed:
  2665.  
  2666.           1)   Ensure that the "&B1" parameter is included in your modem
  2667.                initialization string.
  2668.  
  2669.           2)   Ensure that CTS flow control is enabled.  (This is enabled
  2670.                by the "Mask Handshaking CTS" statement in MAX.CTL.)
  2671.  
  2672.           3)   Use the -s<speed> command-line parameter when starting
  2673.                Maximus to handle remote callers.  For example, to use a
  2674.                locked port rate of 38.4kbps, the following command-line
  2675.                could be used:
  2676.  
  2677.                max -s38400 -w
  2678.  
  2679.                The '-s38400' parameter instructs Maximus to talk to the
  2680.                serial port at 38.4kbps only.  The modem itself will handle
  2681.                all rate negotiation with the remote system.
  2682.  
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.                    Maximus 2.02 System Operations Manual - Page 46
  2689.  
  2690.  
  2691.  
  2692.  
  2693.           Step 4:   Editing Configuration Files
  2694.  
  2695.           In order to run Maximus on your system, you will need to make
  2696.           several changes to your system set-up, especially in your
  2697.           CONFIG.SYS and AUTOEXEC.BAT files.  (DOS only.)
  2698.  
  2699.           Note!  The default OS/2 CONFIG.SYS does not need to be modified
  2700.           to use Maximus/2.  OS/2 users should skip this section.
  2701.  
  2702.           In the CONFIG.SYS file, you'll either need to EDIT the following
  2703.           items if they already exist, or ADD them to the end of CONFIG.SYS
  2704.           if they do not.  A generic text editor can be used to edit your
  2705.           CONFIG.SYS file, but a word processor in 'non-document' mode will
  2706.           also get the job done.
  2707.  
  2708.           The first change you have to make is to the 'BUFFERS=' statement. 
  2709.           (Again, if you do not already have a BUFFERS= statement, add it
  2710.           to the end of CONFIG.SYS.)  If the system you are using is an XT
  2711.           or a PC, make sure that the line reads 'BUFFERS=20'.  However, if
  2712.           you are using an AT or an 80386, this line should read
  2713.           'BUFFERS=30' for improved performance.  The BUFFERS statement
  2714.           controls the amount of space that DOS uses for buffering files
  2715.           that are being read from or written to disk.  Setting the BUFFERS
  2716.           command to the wrong number may slow down your system, but
  2717.           Maximus will still function correctly.
  2718.  
  2719.           A second change must be made to the 'FILES=' statement.  Unlike
  2720.           the BUFFERS= statement, Maximus will not be able to run properly
  2721.           unless you have this statement set to a number GREATER THAN OR
  2722.           EQUAL TO 20.  If you are running under a multitasking environment
  2723.           such as DESQview or DoubleDOS, then this number should be at
  2724.           least double that.  In other words, if you have no multitasker,
  2725.           use 'FILES=20'.  However, if you are running a multitasker, you
  2726.           should use at least 'FILES=40', or else Maximus will probably
  2727.           exhibit erratic behaviour.  Again, if you do not already have a
  2728.           'FILES=' statement, simply add it to the end of your CONFIG.SYS.
  2729.  
  2730.           The third change you must make is to add the line
  2731.           'DEVICE=ANSI.SYS' to the end of your CONFIG.SYS.  If you look on
  2732.           your MS-DOS distribution disk(s), you should find a file called
  2733.           'ANSI.SYS' on one of them.  After making the aforementioned
  2734.           change to CONFIG.SYS, copy ANSI.SYS from your DOS disk to the
  2735.           root directory of your hard disk.
  2736.  
  2737.           Note that Maximus itself does not need ANSI.SYS.  However,
  2738.           certain doors and external programs may require it.
  2739.  
  2740.  
  2741.  
  2742.  
  2743.                    Maximus 2.02 System Operations Manual - Page 47
  2744.  
  2745.  
  2746.  
  2747.           Finally, if you are planning on using Squish areas in a multinode
  2748.           environment, you MUST install a copy of DOS's SHARE.EXE.  This
  2749.           sharing module allows Max to share Squish message bases with
  2750.           other nodes or tasks; using Squish areas in a multinode
  2751.           environment without SHARE will certainly cause damage.  To
  2752.           install share, simply make sure that SHARE.EXE is in your root
  2753.           directory, and then add the line "share" to the end of your
  2754.           AUTOEXEC.BAT.
  2755.  
  2756.           Note to Novell users:  Installing SHARE is not completely
  2757.           necessary.  As long as you load INT2F.COM after Netware shell,
  2758.           you can get away without loading SHARE.
  2759.  
  2760.           Once you have made all of these changes and saved the
  2761.           configuration files, you should press <Ctrl-Alt-Del> to reboot
  2762.           your computer.  Unless you reboot, changes made to CONFIG.SYS and
  2763.           AUTOEXEC.BAT will not take effect.
  2764.  
  2765.  
  2766.  
  2767.  
  2768.  
  2769.  
  2770.  
  2771.  
  2772.  
  2773.  
  2774.  
  2775.  
  2776.  
  2777.  
  2778.  
  2779.  
  2780.  
  2781.  
  2782.  
  2783.  
  2784.  
  2785.  
  2786.  
  2787.  
  2788.  
  2789.  
  2790.  
  2791.  
  2792.  
  2793.  
  2794.  
  2795.  
  2796.  
  2797.  
  2798.                    Maximus 2.02 System Operations Manual - Page 48
  2799.  
  2800.  
  2801.  
  2802.  
  2803.           Step 5:   Setting Up Control Files
  2804.  
  2805.           This is the most complicated step in setting up your BBS. 
  2806.           Maximus has four basic configuration files which control the
  2807.           operation of your system: MAX.CTL, FILEAREA.CTL, MSGAREA.CTL, and
  2808.           MENUS.CTL.  MAX.CTL is the main control file, and it controls
  2809.           almost everything about your system from the log-on screens
  2810.           displayed to the time 'reward' given to users who upload. 
  2811.           MSGAREA.CTL controls all of the message areas on your BBS;
  2812.           FILEAREA.CTL controls all of the file areas, and MENUS.CTL
  2813.           controls all of the menus and options.  The control files are all
  2814.           straight ASCII text, so to edit these files, you must either use
  2815.           a text editor, or a word-processor in a "non- document" or ASCII
  2816.           mode.
  2817.  
  2818.           There are a lot of fairly complicated commands in these control
  2819.           files, but they give you control over even the most minute
  2820.           aspects of your BBS.  Along with this power to tailor your BBS to
  2821.           your particular needs, there also comes the potential for
  2822.           screwing things up.  Therefore, if you are a new SysOp, it is
  2823.           advised that you refrain from playing too much with these files
  2824.           until you get your BBS up and running, and have become more
  2825.           familiar with the various options which are available.
  2826.  
  2827.           The installation program has already customized most of the
  2828.           system control files, so you do not need to do anything just yet. 
  2829.           However, make sure that you know how to edit your control files,
  2830.           and make sure that your editor can handle plain ASCII files.
  2831.  
  2832.  
  2833.  
  2834.  
  2835.  
  2836.  
  2837.  
  2838.  
  2839.  
  2840.  
  2841.  
  2842.  
  2843.  
  2844.  
  2845.  
  2846.  
  2847.  
  2848.  
  2849.  
  2850.  
  2851.  
  2852.  
  2853.                    Maximus 2.02 System Operations Manual - Page 49
  2854.  
  2855.  
  2856.  
  2857.  
  2858.           Step 6:   Compiling the Control Files
  2859.  
  2860.           Once you have made all of the required changes to MAX.CTL, the
  2861.           next step is to 'compile' your control files.  If you make any
  2862.           changes to your control files and forget to compile them, Maximus
  2863.           will not realize that anything has changed, and will still run
  2864.           using your old configuration.
  2865.  
  2866.           Note!  The idiot-proof configuration program already compiled
  2867.           your control file for the first time.  However, it is a good idea
  2868.           to compile it again here, just so that you can learn how to
  2869.           compile everything properly.
  2870.  
  2871.           Compiling your control files is easy; the program that compiles
  2872.           all of your control files is called SILT.  Just type in the
  2873.           command 'SILT <ctlname>' and press <enter>, where <ctlname> is
  2874.           the name of your main control file.  If you are working with the
  2875.           default configuration, then 'SILT MAX' should get you running and
  2876.           compile all four of the control files.
  2877.  
  2878.           The main MAX.CTL has 'Include' statements near the end which tell
  2879.           SILT to read in MENUS.CTL, FILEAREA.CTL and MSGAREA.CTL
  2880.           automatically.  You cannot compile the other control files
  2881.           individually, so you must always give SILT the name of the main
  2882.           control file.
  2883.  
  2884.           The first time you run SILT, it will probably complain that a few
  2885.           directories did not exist, and that it is creating them for you. 
  2886.           You need not worry, since this is perfectly normal.  If you have
  2887.           made any errors in the control file, such as misspelling a
  2888.           keyword, SILT will warn you about those too.  If you have made
  2889.           any errors, restart your text editor, move to the specified line
  2890.           number, fix the error, and then recompile using SILT.
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.                    Maximus 2.02 System Operations Manual - Page 50
  2909.  
  2910.  
  2911.  
  2912.  
  2913.           Step 7:   Starting Maximus
  2914.  
  2915.           Once you have compiled your control files, you are finally ready
  2916.           to start Maximus.  Although your BBS is still fairly bare-bones,
  2917.           it will be partially usable.
  2918.  
  2919.           To start up Maximus for the first time, CD to the \MAX directory
  2920.           and type in the command "max -c".  The '-c' switch tells Maximus
  2921.           to create a new user file, so you should only do this the first
  2922.           time you run Max.  (If you are converting from another BBS
  2923.           program, now would be a good time to run CVTUSR.)
  2924.  
  2925.           After a bit of disk activity, Maximus should display a copyright
  2926.           banner, and print out a message about the lack of an existing
  2927.           user file.  Maximus will then display the prompt: 
  2928.           "Your Name Here [Y,n]?", where "Your Name Here" is the name
  2929.           entered in the "SysOp" box of the installation program.  Type the
  2930.           letter 'Y' to continue your logon.
  2931.  
  2932.           After doing this, Maximus will display a bit of text which
  2933.           describes your BBS.  This text is contained in a file called
  2934.           \MAX\MISC\APPLIC.MEC.  (Files with an extension of .MEC will be
  2935.           discussed in greater detail later in this document.)
  2936.  
  2937.           Maximus will also prompt you for a few pieces of information,
  2938.           including your city, phone number, and password.  Maximus will
  2939.           also prompt you for ANSI screen controls, the MaxEd editor,
  2940.           IBM-PC characters, and hotkeys.  Answer 'Y' to all four of these
  2941.           prompts.
  2942.  
  2943.           After Maximus has finished the interrogation, it will display a
  2944.           welcome screen and a bulletin file, and will then finally place
  2945.           you at the main menu.  All of these screens are completely
  2946.           redefinable.  Such customization will be described later in this
  2947.           manual.
  2948.  
  2949.           Now that you have Maximus working, you will probably want to look
  2950.           around for a while.  Feel free to play around, and explore the
  2951.           different features of your new BBS.  If you would like to send
  2952.           some test NetMail, try going into the user editor and giving
  2953.           yourself some matrix credit.
  2954.  
  2955.           When you have finished looking around at your new BBS, type 'G'
  2956.           from any menu to log off, and Maximus will exit back to the
  2957.           command prompt.
  2958.  
  2959.  
  2960.  
  2961.  
  2962.  
  2963.                    Maximus 2.02 System Operations Manual - Page 51
  2964.  
  2965.  
  2966.  
  2967.  
  2968.           Step 8:   Support for Remote Callers
  2969.  
  2970.           To handle non-local callers, Maximus needs to be run from a batch
  2971.           file.  Although Max can be run locally from the command-line, to
  2972.           properly support external callers, a batch file must be created
  2973.           to recycle your system after a caller hangs up.  In the case of a
  2974.           power failure, your batch files should also be capable of
  2975.           restarting the BBS without intervention.
  2976.  
  2977.           There are two mutually-exclusive methods of running Max:
  2978.  
  2979.           1)   Max can be run using the internal Waiting For Caller (WFC)
  2980.                subsystem.  WFC handles all of the modem manipulation inside
  2981.                of Maximus, so no external programs are required to answer
  2982.                the phone.  Max will answer the phone, flush out any MNP
  2983.                garbage, and drop immediately to the main BBS.
  2984.  
  2985.           2)   Max can also be run under a "front end".  A front end is a
  2986.                program which answers the phone, optionally performs some
  2987.                additional processing, and then passes control to the BBS. 
  2988.                Front ends are commonly used for FidoNet support, since the
  2989.                FTSC-0001 protocol layer is not built into most BBS
  2990.                software.  If you wish to become a member of FidoNet, you
  2991.                must run a front end.
  2992.  
  2993.           In addition, a combination of these two methods is available for
  2994.           multi-node systems.  In most cases, only one node needs to have a
  2995.           FidoNet address, so one line of your system can run a front end,
  2996.           whereas the other lines can use the internal WFC module.  (All of
  2997.           this is possible using the same set of control files!)
  2998.  
  2999.  
  3000.           Running the MODE command (OS/2 only)
  3001.  
  3002.           If you are running Maximus under OS/2, special care must be taken
  3003.           to set up the communications port before calling Maximus.  In
  3004.           most cases, this port set-up is performed by using the OS/2
  3005.           'MODE' command.
  3006.  
  3007.           The MODE command is used to set the port speed, flow control
  3008.           characteristics, and buffering settings.
  3009.  
  3010.           In most cases, the following command should be issued before
  3011.           trying to run Maximus with a remote caller.  (This command should
  3012.           be entered all on one line, without any spaces.)
  3013.  
  3014.                MODE COM<port>:<speed>,n,8,1,,TO=OFF,XON=ON,IDSR=OFF,
  3015.                ODSR=OFF,OCTS=ON,DTR=ON,RTS=HS
  3016.  
  3017.  
  3018.                    Maximus 2.02 System Operations Manual - Page 52
  3019.  
  3020.  
  3021.  
  3022.  
  3023.           In the above command, <port> is the 1-based com port number of
  3024.           your Maximus system.  <speed> is the maximum communications rate
  3025.           supported by your modem.  This line should be included in the
  3026.           batch file that starts Maximus.
  3027.  
  3028.           For example, to configure com port 1 for 38,400 bps, the
  3029.           following command should be used:
  3030.  
  3031.                MODE COM1:38400,n,8,1,,TO=OFF,XON=ON,IDSR=OFF,
  3032.                ODSR=OFF,OCTS=ON,DTR=ON,RTS=HS
  3033.  
  3034.           If your modem has special flow control requirements, please see
  3035.           the documentation for the OS/2 MODE command for more information. 
  3036.           (Type "help mode" from the OS/2 prompt)
  3037.  
  3038.  
  3039.           Using the Internal WFC Module
  3040.  
  3041.           When run in this mode, Maximus will handle incoming callers on
  3042.           its own.  The first principle of WFC mode is the "-w" command
  3043.           line switch.  To start Max in the most basic WFC mode, the
  3044.           following command should be used:
  3045.  
  3046.                max -w
  3047.  
  3048.           "-w" instructs Maximus to enter WFC mode.  After this command is
  3049.           executed, Maximus will load up, display a few windows, initialize
  3050.           the modem, and wait for an incoming call.  Max will autodetect
  3051.           the incoming caller's speed and switch baud rates automatically.
  3052.  
  3053.           By default, Maximus is set up to run on any Hayes-compatible
  3054.           modem.  If the WFC subsystem does not seem to be answering the
  3055.           phone correctly, read the comments in the Equipment section of
  3056.           MAX.CTL.  You may have to fiddle with the command strings, but
  3057.           most modems can be made to work with Maximus.
  3058.  
  3059.           In addition to the standard "-w" switch, you can also use the "-
  3060.           b" (baud rate) and "-p" (com port) switches to specify an
  3061.           alternate port number and maximum baud rate for the current node,
  3062.           overriding the defaults in the control file.  For example, to
  3063.           start WFC on port 2 with a baud rate of 38400, specify the
  3064.           following command:
  3065.  
  3066.                max -w -p2 -b38400
  3067.  
  3068.           To run WFC with a high-speed modem (9600+ bps), either see your
  3069.           FOSSIL documentation about locking your FOSSIL driver, or see the
  3070.  
  3071.  
  3072.  
  3073.                    Maximus 2.02 System Operations Manual - Page 53
  3074.  
  3075.  
  3076.  
  3077.           documentation on the "-s" command-line switch in the Maximus
  3078.           Technical Reference Manual.
  3079.  
  3080.           For example, to run Maximus with a high-speed modem on COM2,
  3081.           locked at 38.4kbps, the following command could be used:
  3082.  
  3083.                max -w -p2 -s38400
  3084.  
  3085.           No matter which options you use, the command line must always
  3086.           include a "-w" if you wish to handle remote callers.  This
  3087.           command must be placed in your batch file where you wish Max to
  3088.           be run.
  3089.  
  3090.           The WFC module can also handle timed events which are run at
  3091.           specified times of the day.  Please see the section entitled
  3092.           "WAITING FOR CALLER SUBSYSTEM".
  3093.  
  3094.  
  3095.           Using an External Front End
  3096.  
  3097.           In this mode, Maximus will not answer the telephone by itself. 
  3098.           Since you are probably using this mode for FidoNet compatibility,
  3099.           you'll need a "front end" or a "mailer" to handle incoming and
  3100.           outgoing calls.  There are six or seven FidoNet-compatible
  3101.           mailers freeware/shareware market, and three or four in the
  3102.           commercial market, so you have plenty to choose from.  (At the
  3103.           time of this writing, the two most common mailers are BinkleyTerm
  3104.           and FrontDoor.)
  3105.  
  3106.           Although setting up your front-end mailer is beyond the scope of
  3107.           this document, you will find several sample batch files for
  3108.           different mailers in the appendices in the Maximus Technical
  3109.           Reference Manual.
  3110.  
  3111.           Your mailer's documentation may have some specific details for
  3112.           hooking it up to a Maximus system; if so, you should follow those
  3113.           directions.  If not, read on.  When Maximus starts up with a
  3114.           caller already on-line, it expects to find a minimum of one
  3115.           parameter:  '-b<speed>', where <speed> is the baud rate of the
  3116.           caller currently on-line.  Generally, this is handled through
  3117.           errorlevels or through a batch file called SPAWNBBS.BAT or
  3118.           EXEBBS.BAT.
  3119.  
  3120.  
  3121.           Maximus Errorlevels
  3122.  
  3123.           Once you are able to run Max for a remote caller (either through
  3124.           the WFC or from your front end), you are halfway there.  When
  3125.           Maximus terminates, it needs to tell your system what to do next. 
  3126.  
  3127.  
  3128.                    Maximus 2.02 System Operations Manual - Page 54
  3129.  
  3130.  
  3131.  
  3132.           For example, if a user entered an EchoMail message, you may want
  3133.           to run a utility (such as Squish) to process that message, or you
  3134.           may wish to run some sort of logging utility.  To accomplish
  3135.           this, Maximus sets a numeric variable in DOS called an
  3136.           'errorlevel'.  As mentioned earlier, Maximus has several
  3137.           errorlevels to juggle for various events, such as a user entering
  3138.           an echomail message, a user entering a netmail message, logging
  3139.           off before the user enters a name, etc.
  3140.  
  3141.           You'll note that in several places throughout the control file,
  3142.           you can tell Maximus which errorlevel to use in certain
  3143.           situations.  Errorlevels are always numeric, and always have a
  3144.           value from 1 through 255.  (However, Maximus reserves errorlevels
  3145.           1 through 4 to indicate errors, so you should not use these in
  3146.           the control file.)  The control file comes pre-set with certain
  3147.           errorlevels, so unless you have a special case, you should not
  3148.           need to modify these.
  3149.  
  3150.           Once Maximus is set up to use errorlevels, the only other task is
  3151.           to make your batch file detect the errorlevel Maximus used, and
  3152.           react accordingly.  Errorlevels can be detected in a batch file
  3153.           quite easily, through the use of the 'If Errorlevel <e> <a>'
  3154.           statement.  <e> is a number, and should indicate the actual
  3155.           errorlevel to check for, and should also correspond to the
  3156.           errorlevel specified in MAX.CTL.  <a> specifies an action, which
  3157.           is simply a normal batch file command.
  3158.  
  3159.           However, there is one item to which you should pay special
  3160.           attention:
  3161.  
  3162.           DOS examines all errorlevels using a greater-than-or-equal-to
  3163.           operation.  In other words,the statement 'If ErrorLevel 10 echo
  3164.           Hi!' will display the word 'Hi!' if the errorlevel was set to 10,
  3165.           but will ALSO display 'Hi!' if the errorlevel was set to 11, 12,
  3166.           or above.  For this reason, if you have more than one errorlevel
  3167.           to check for, you should always arrange the group of errorlevel
  3168.           statements in a DESCENDING order.  For example, to check for
  3169.           errorlevels 1, 3, 9, 10, 11 and 12, this would be the proper way
  3170.           to place the statements in your batch file:
  3171.  
  3172.  
  3173.  
  3174.  
  3175.  
  3176.  
  3177.  
  3178.  
  3179.  
  3180.  
  3181.  
  3182.  
  3183.                    Maximus 2.02 System Operations Manual - Page 55
  3184.  
  3185.  
  3186.  
  3187.                MAX -p%1 -b%2 (other switches here; use "-w" instead for WFC
  3188.                mode)
  3189.  
  3190.                If ErrorLevel 12  (Do op 'A' here.)
  3191.                If ErrorLevel 11  (Do op 'B' here.)
  3192.                If ErrorLevel 10  (Do op 'C' here.)
  3193.                If ErrorLevel  9  (Do op 'D' here.)
  3194.                If ErrorLevel  3  (Do op 'E' here.)
  3195.                If ErrorLevel  1  (Do op 'F' here.)
  3196.  
  3197.           The only other point to remember is that ALL programs modify the
  3198.           DOS errorlevel.  In the example given above, if you were to run a
  3199.           program called (for example) ABCD.EXE for the 'If ErrorLevel 12'
  3200.           statement, ABCD would RESET the DOS errorlevel after ABCD.EXE
  3201.           terminated.  Since the batch file is executed one line at a time,
  3202.           the errorlevel statements which follow would use the errorlevel
  3203.           set by the ABCD program, rather than the value set by Maximus. 
  3204.           To get around this DOS limitation, you must instead use a GOTO
  3205.           statement for the 'action' portion of the errorlevel statement.
  3206.  
  3207.           The GOTO command allows your batch file to jump to a completely
  3208.           different location within the same batch file, and start
  3209.           executing commands from that point.  This is accomplished by
  3210.           using a statement in the form of 'GOTO <l>', where <l> is a
  3211.           LABEL.  A label is a unique, alphanumeric, ONE-WORD name, which
  3212.           indicates where in the batch file you wish to jump to.  Some
  3213.           valid labels could be called 'DoScan', 'Heres_The_Scoop', and
  3214.           'ScanBLD'.  However, a GOTO statement alone is not enough to
  3215.           complete the GOTO operation.  You must also place the same label
  3216.           somewhere else within the batch file, which lets DOS know where
  3217.           the GOTO statement should end up.  You can do this simply by
  3218.           placing a colon (':') at the beginning of a line, simply followed
  3219.           by the label name.
  3220.  
  3221.           For example, the following sample batch file:
  3222.  
  3223.           Line 1:   :BigLoop
  3224.           Line 2:   echo This will be shown repeatedly
  3225.           Line 3:   goto BigLoop
  3226.  
  3227.           ...would cause the line 'This will be shown repeatedly' to
  3228.           continuously display on the screen, until the user hits control-C
  3229.           to abort.  (Omit the 'Line X:' tags when typing this in.)  When
  3230.           DOS starts the batch file, it will process each line in sequence. 
  3231.           When DOS reads line 1, it will recognize that 'BigLoop' is simply
  3232.           a label definition, and will ignore it.  Next, DOS will read line
  3233.           2, and process the ECHO command, by displaying 'This will be
  3234.           shown repeatedly' on the screen.  Once DOS encounters line 3, it
  3235.           will realize that it contains a GOTO statement, and will parse
  3236.  
  3237.  
  3238.                    Maximus 2.02 System Operations Manual - Page 56
  3239.  
  3240.  
  3241.  
  3242.           the label 'BigLoop' out of the command.  Having done that, DOS
  3243.           will then scan for the prior ':BigLoop' label, and jump back to
  3244.           line 1, thus continuing the cycle.
  3245.  
  3246.           However, the GOTO command does have practical applications.  The
  3247.           above example could be re-written like this:
  3248.  
  3249.                MAX (command line switches here)
  3250.  
  3251.                If ErrorLevel 12  goto OpA
  3252.                If ErrorLevel 11  goto OpB
  3253.                If ErrorLevel 10  goto OpC
  3254.                If ErrorLevel  9  goto OpD
  3255.                If ErrorLevel  3  goto OpE
  3256.                If ErrorLevel  1  goto OpF
  3257.  
  3258.                :OpA
  3259.                REM * Do operation 'A' here.
  3260.                goto End
  3261.  
  3262.                :OpB
  3263.                REM * Do operation 'B' here.
  3264.                goto End
  3265.  
  3266.                :OpC
  3267.                REM * Do operation 'C' here.
  3268.                goto End
  3269.  
  3270.                :OpD
  3271.                REM * Do operation 'D' here.
  3272.                goto End
  3273.  
  3274.                :OpE
  3275.                REM * Do operation 'E' here.
  3276.                goto End
  3277.  
  3278.                :OpF
  3279.                REM * Do operation 'F' here.
  3280.                goto End
  3281.  
  3282.                :End
  3283.  
  3284.  
  3285.           In this situation, DOS would first compare the errorlevel
  3286.           returned by Maximus to those listed in the 'If ErrorLevel'
  3287.           portion of the batch file, and then jump down to the
  3288.           corresponding label.
  3289.  
  3290.  
  3291.  
  3292.  
  3293.                    Maximus 2.02 System Operations Manual - Page 57
  3294.  
  3295.  
  3296.  
  3297.           For example, if Maximus exited using errorlevel 10, DOS would
  3298.           jump down to ':OpC', and process the statements which followed. 
  3299.           The REM statement is simply a remark, and is ignored by DOS. 
  3300.           (Typically, there would be one or more programs run in that
  3301.           portion of the batch file, as opposed to just the REM command.)
  3302.  
  3303.           After processing the REM command, DOS then reads the next line of
  3304.           the batch file, and processes it.  The 'goto End' statement is
  3305.           necessary, to make sure that DOS does not keep going, and execute
  3306.           the commands for 'OpD' as well.  (Recall that DOS just ignores
  3307.           LABEL DEFINITIONS, such as ':OpD'.  Without the extra 'goto End',
  3308.           the batch file would just 'fall through' to the statements under
  3309.           OpD, OpE, etc.  The extra goto specifically instructs DOS to jump
  3310.           to the ':End' label, which is located at the end of the batch
  3311.           file.
  3312.  
  3313.           On the other hand, some times you may WANT the batch file to
  3314.           'fall through', since it allows one to have several similar
  3315.           commands to be processed, when using the same errorlevel. 
  3316.           Fortunately, cases where intentional fall-throughs are needed are
  3317.           few and far between.)
  3318.  
  3319.           Arranging the batch file like this allows for more than one
  3320.           command to be executed for a certain errorlevel, and in addition,
  3321.           gets around the above-mentioned problem of other programs
  3322.           changing the errorlevel.
  3323.  
  3324.           Max's errorlevel numbers higher than 5 are completely
  3325.           configurable, but if you are using the default configuration, the
  3326.           following errorlevels will be used:
  3327.  
  3328.           *    Errorlevel 255:  This means that Maximus terminated with an
  3329.                undefined error condition.  Your batch file should return to
  3330.                your front-end mailer.
  3331.  
  3332.           *    Errorlevel 12:  This indicates that a user entered EchoMail
  3333.                and perhaps also NetMail during this session.  In response,
  3334.                your batch file should call whatever scanner/packer program
  3335.                you use, such as SQUISH OUT SQUASH.  If you are using *.MSG
  3336.                areas, you should also call SCANBLD at this point.  After
  3337.                calling all of these external programs, your batch file
  3338.                should then restart your mailer.
  3339.  
  3340.           *    Errorlevel 11:  This indicates that a user entered NetMail
  3341.                but no EchoMail during this session.  In response, your
  3342.                batch file should call your mail packer, such as SQUISH
  3343.                SQUASH or oMMM.  After calling the packer, your batch file
  3344.                should then restart your mailer.
  3345.  
  3346.  
  3347.  
  3348.                    Maximus 2.02 System Operations Manual - Page 58
  3349.  
  3350.  
  3351.  
  3352.           *    Errorlevel 5:  This indicates that a user logged off without
  3353.                entering either EchoMail or NetMail during his/her session. 
  3354.                In response, your batch file can execute a program such as
  3355.                the SCANBLD mail database utility.  Alternatively, you may
  3356.                have your batch file simply restart your mailer.
  3357.  
  3358.           *    Errorlevels 4 and 3:  These errorlevels are used to indicate
  3359.                an error condition.  Detecting either errorlevel 4 or
  3360.                errorlevel 4 should cause your batch file to restart your
  3361.                mailer (or to reload Max in WFC mode).
  3362.  
  3363.           *    Errorlevel 2:  Errorlevel indicates that the caller hung up
  3364.                before entering a valid name at the log-on prompt.
  3365.  
  3366.           *    Errorlevel 1:  This errorlevel indicates that the SysOp
  3367.                pressed <Alt-X> at the WFC screen.  When your batch file
  3368.                receives this errorlevel, it should exit back to the
  3369.                operating system.
  3370.  
  3371.           A generic batch file for Maximus (in WFC mode) might look
  3372.           something like this:
  3373.  
  3374.           @echo off
  3375.  
  3376.           rem * DOS users only:
  3377.           rem *
  3378.           rem * This line loads your FOSSIL driver.
  3379.  
  3380.           bnu
  3381.  
  3382.           rem * OS/2 users only:
  3383.           rem * 
  3384.           rem * Comment out the above call to BNU and uncomment
  3385.           rem * the following MODE command.  (This command should
  3386.           rem * all be on one line.)
  3387.           rem *
  3388.           rem * mode com1:38400,n,8,1,,TO=OFF,XON=ON,IDSR=OFF,ODSR=OFF,
  3389.           rem * OCTS=ON,DTR=ON,RTS=HS
  3390.  
  3391.  
  3392.           rem * This is where you call Maximus itself.  Change
  3393.           rem * the '%1' and '%2' as necessary, to make Maximus
  3394.           rem * work with your mailer.  (See the appendix on Sample
  3395.           rem * Batch Files for more information.)
  3396.  
  3397.           :Loop
  3398.           MAX -w (command line switches here)
  3399.           if errorlevel 255 goto Error
  3400.           if errorlevel 16  goto Error
  3401.  
  3402.  
  3403.                    Maximus 2.02 System Operations Manual - Page 59
  3404.  
  3405.  
  3406.  
  3407.           if errorlevel 12  goto EchoMail
  3408.           if errorlevel 11  goto NetMail
  3409.           if errorlevel  5  goto Aftercall
  3410.           if errorlevel  4  goto Error
  3411.           if errorlevel  3  goto Error
  3412.           if errorlevel  2  goto Loop
  3413.           if errorlevel  1  goto Done
  3414.  
  3415.  
  3416.           :EchoMail
  3417.           rem * Invoke scanner and packer here.  Next, go to the
  3418.           rem * 'Aftercall' label to process any after-caller actions.
  3419.           rem *
  3420.           rem * For the Squish mail processor, use the following command:
  3421.           rem
  3422.           rem SQUISH OUT SQUASH -fc:\max\echotoss.log
  3423.  
  3424.           goto Aftercall
  3425.  
  3426.  
  3427.  
  3428.           :NetMail
  3429.           rem * Invoke packer here, then go to the 'Aftercall' label.
  3430.           rem
  3431.           rem For the Squish mail processor, use the following command:
  3432.           rem
  3433.           rem SQUISH SQUASH
  3434.  
  3435.           goto Aftercall
  3436.  
  3437.  
  3438.  
  3439.           :Aftercall
  3440.           rem * Invoke after-each-caller utilities here.
  3441.           goto End
  3442.  
  3443.  
  3444.  
  3445.           :Error
  3446.           rem * Something bad happened, so let's say so.
  3447.  
  3448.           echo There has been an error!
  3449.           goto Down
  3450.  
  3451.  
  3452.  
  3453.           :End
  3454.           rem * This label should re-load your phone answering program.
  3455.           rem * If you are using the Maximus WFC, you should use the
  3456.  
  3457.  
  3458.                    Maximus 2.02 System Operations Manual - Page 60
  3459.  
  3460.  
  3461.  
  3462.           rem * following line to jump back up to the top of the loop:
  3463.            
  3464.           goto Loop
  3465.  
  3466.           rem * If you are using FrontDoor, BinkleyTerm or another front
  3467.           rem * end, you should comment out the above 'goto' and
  3468.           rem * uncomment the following line:
  3469.           rem
  3470.           rem exit
  3471.           rem
  3472.           rem * WARNING!  BinkleyTerm-OS/2 users must always use the
  3473.           rem * "Spawn" method of executing Maximus.
  3474.  
  3475.  
  3476.           :Down
  3477.  
  3478.           rem * The system arrives here if there was a problem
  3479.           echo Error!  Maximus had a fatal error and could not continue!
  3480.  
  3481.           :Done
  3482.           exit
  3483.  
  3484.  
  3485.           Finally, if you are using any *.MSG message areas, it would be a
  3486.           good idea to read the chapter on SCANBLD right now.  (SCANBLD is
  3487.           discussed in the "Maximus Utility Documentation" section of this
  3488.           manual.)  When using *.MSG areas, SCANBLD updates the index file
  3489.           for each area, so you'll have to use it after every caller.  In
  3490.           the sample batch file above, the call to SCANBLD would go under
  3491.           the label marked ':Aftercall'.
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.                    Maximus 2.02 System Operations Manual - Page 61
  3514.  
  3515.  
  3516.  
  3517.  
  3518.           Step 9:   Events and Yelling
  3519.  
  3520.           The distribution copy of Maximus comes with a pre-configured
  3521.           event file.  This "event file" serves two purposes:
  3522.  
  3523.           1)   With the internal Waiting for Caller subsystem, the event
  3524.                file is used to schedule "external events".  External events
  3525.                are used for running external programs at predetermined
  3526.                times.  These events are useful for nightly maintenance,
  3527.                general cleanup, and anything else you may desire.
  3528.  
  3529.           2)   "Yell events" are also controlled through the events control
  3530.                file.  Yell events are used to define when callers are
  3531.                allowed to page the SysOp, how long the page should last,
  3532.                and which tune to play while the SysOp is being paged.  Yell
  3533.                events are configured just like external events, except that
  3534.                a yell number is specified instead of an errorlevel.
  3535.  
  3536.           All events are kept in the file called EVENTSxx.BBS, where 'xx'
  3537.           is the current task number.  (For a system with no task number,
  3538.           use '00' for 'xx'.)  Each node on a multi-node system must have a
  3539.           separate events file.  However, all of the event files use the
  3540.           same format, so you can simply copy a master events file to
  3541.           EVENTS01.BBS, EVENTS02.BBS, and so on.
  3542.  
  3543.  
  3544.           Yell Events
  3545.  
  3546.           The distribution version of Maximus comes with an event file
  3547.           called EVENTS00.BBS.  This event file contains a single yell
  3548.           event which is active between 13:00 and 23:00 (local time).  You
  3549.           should read the comments in the event file for details, but you
  3550.           can add alternate yell time slots by simply duplicating that line
  3551.           and inserting the appropriate starting and ending times.
  3552.  
  3553.           One thing to note are the numbers in the "Y3/3/1" flag.  The
  3554.           first "3" specifies that the bell or tune will be played three
  3555.           times.  The second "3" specifies that the user can yell up to
  3556.           three times in a row before Max will automatically turn off the
  3557.           Y)ell command.  The final "1" specifies that tune #1 will be
  3558.           played from TUNES.BBS.
  3559.  
  3560.           Max has an external file called TUNES.BBS which can be used to
  3561.           play simple notes and melodies on the local speaker.  The
  3562.           comments in TUNES.BBS describe the structure of the file in more
  3563.           detail, but it essentially contains any number of notes, each
  3564.           note consisting of a frequency and a duration.
  3565.  
  3566.  
  3567.  
  3568.                    Maximus 2.02 System Operations Manual - Page 62
  3569.  
  3570.  
  3571.  
  3572.           The tunes file can contain more than one tune; Max will play the
  3573.           tune "Yell1" when a user yells, since the distribution events
  3574.           file includes a "1" in the default yell event.  The distribution
  3575.           version of the tunes file also includes "Yell2", "Yell3", "Yell4"
  3576.           and "Yell5", so you can try changing the last number of the yell
  3577.           event to produce different sounds.  If you desire, you can also
  3578.           create your own tunes file.
  3579.  
  3580.  
  3581.           External Events
  3582.  
  3583.           As mentioned above, the events file also supports external
  3584.           events.  (These events are only active when using the internal
  3585.           WFC.)  To add an external event, simply add a line to
  3586.           EVENTSxx.BBS with the appropriate starting time, and add an
  3587.           "E<erl>" flag to the end of the line.  <erl> specifies the
  3588.           errorlevel that Max will exit with at the specified time.  After
  3589.           creating an entry for the event in EVENTSxx.BBS, you should
  3590.           modify your batch files to "trap" the specified errorlevel and to
  3591.           run your external event when that errorlevel is found.
  3592.  
  3593.           For more information, see either the comments in the distribution
  3594.           EVENTS00.BBS or the section entitled "EVENTS.BBS CONFIGURATION"
  3595.           in the Maximus Technical Reference Manual.
  3596.  
  3597.  
  3598.  
  3599.  
  3600.  
  3601.  
  3602.  
  3603.  
  3604.  
  3605.  
  3606.  
  3607.  
  3608.  
  3609.  
  3610.  
  3611.  
  3612.  
  3613.  
  3614.  
  3615.  
  3616.  
  3617.  
  3618.  
  3619.  
  3620.  
  3621.  
  3622.  
  3623.                    Maximus 2.02 System Operations Manual - Page 63
  3624.  
  3625.  
  3626.  
  3627.  
  3628.           Step 10:  About Priv Levels and Locks
  3629.  
  3630.           Unlike other BBS programs, Maximus does not use numbers to
  3631.           represent a user's access level.  Instead, Maximus uses a series
  3632.           of keywords, which are called 'Priv Levels'.  Listed in
  3633.           descending order, the following privilege levels are currently
  3634.           supported:
  3635.  
  3636.                Hidden (special, see note below)
  3637.                SysOp
  3638.                AsstSysOp
  3639.                Clerk
  3640.                Extra
  3641.                Favored
  3642.                Privil
  3643.                Worthy
  3644.                Normal
  3645.                Limited
  3646.                Disgrace
  3647.                Twit
  3648.  
  3649.           All of these privilege levels, except for 'Hidden', can be
  3650.           applied to an ordinary user or menu command.  The'Hidden'
  3651.           privilege level is a special case, and if applied to a user, it
  3652.           ensures that the user will NOT be able to log onto your system,
  3653.           since Maximus will disconnect as soon as the user enters his/her
  3654.           password.  Similarly, setting a menu option or a message/file
  3655.           area priv of 'Hidden' means that nobody can access that option -
  3656.           not even the SysOp.  This is useful for hiding commands that you
  3657.           do not want even yourself to be able to access.
  3658.  
  3659.           The only privilege level which confers special capabilities is
  3660.           that of 'SysOp'.  For example, users with the privilege level of
  3661.           SysOp can read private messages in any area, regardless of who
  3662.           the actual addressee is.  It should be noted that simply having
  3663.           your name listed in the 'SysOp' section of the control file does
  3664.           NOT automatically confer SysOp privileges upon you.  Your actual
  3665.           user profile, contained in the USER.BBS data file, must have your
  3666.           privilege level set to 'SysOp'.
  3667.  
  3668.           The remaining privilege levels do not confer any special
  3669.           capabilities and can be assigned to any users you wish,
  3670.           regardless of what the name of the privilege level implies.  The
  3671.           privilege levels that are required to access menu options and
  3672.           message/file areas are controlled in MENUS.CTL and
  3673.           MSGAREA.CTL/FILEAREA.CTL, respectively.  These three files will
  3674.           be discussed later in this document.
  3675.  
  3676.  
  3677.  
  3678.                    Maximus 2.02 System Operations Manual - Page 64
  3679.  
  3680.  
  3681.  
  3682.           When first setting up your BBS, try and define a set of rules for
  3683.           using privilege levels.  For example:  "First-time callers get a
  3684.           privilege level of DISGRACE, validated users get a privilege
  3685.           level of NORMAL, and users who have donated money to the SysOp
  3686.           receive a privilege level of PRIVIL."  If you do not lay out a
  3687.           plan for assigning privilege levels when you first start out, you
  3688.           will find it very easy to lose track later in the game of who has
  3689.           access to what.
  3690.  
  3691.           Privilege levels are not the only way to control user access to
  3692.           various areas or menu options, since Max has a "lock and key"
  3693.           system.  Using Max's locks, you can give specific users access to
  3694.           certain areas or options independently of that user's priv level. 
  3695.           Once an option or area is 'locked' with a specific lock number, a
  3696.           user must have the same key number to access that particular
  3697.           option or area.  Valid lock/keys are numbers from 1 to 8 and
  3698.           letters from A to X.
  3699.  
  3700.           To add a lock to a message/file area or a menu option, simply add
  3701.           a forward slash after the privilege level, followed by the lock
  3702.           characters you wish to use.  To illustrate, an area with an
  3703.           access level of 'Privil/167AQX' would be accessible to only those
  3704.           users whose privilege level was at least 'Privil', and who had
  3705.           keys 1, 6, 7, A, Q, and X.
  3706.  
  3707.           You can modify a user's keys in the user editor (through the keys
  3708.           command).  User keys can also be modified on-line, using the keys
  3709.           1 through 8 on your keyboard.  Alphanumeric keys can be also
  3710.           toggled through the priv level window, accessible through the 'S'
  3711.           option on the SysOp screen.
  3712.  
  3713.  
  3714.  
  3715.  
  3716.  
  3717.  
  3718.  
  3719.  
  3720.  
  3721.  
  3722.  
  3723.  
  3724.  
  3725.  
  3726.  
  3727.  
  3728.  
  3729.  
  3730.  
  3731.  
  3732.  
  3733.                    Maximus 2.02 System Operations Manual - Page 65
  3734.  
  3735.  
  3736.  
  3737.  
  3738.           Step 11:  Customizing *.BBS Files
  3739.  
  3740.           Now that Maximus is functional, you are probably interested in
  3741.           customizing the screens and menus.  Your first step will probably
  3742.           be to modify the welcome screens and information files which came
  3743.           with the default Maximus package.
  3744.  
  3745.           Almost all of the display files are stored in your \MAX\MISC
  3746.           subdirectory, so this is where you will be doing most of your
  3747.           customization work.  Different files are used for different
  3748.           purposes, and each file has its own unique name.  For example,
  3749.           the first screen displayed to a new user is stored in a file
  3750.           called APPLIC.BBS, the bulletins are stored in BULLETIN.BBS, etc. 
  3751.           You can change these filenames in MAX.CTL if you want, but it
  3752.           will be simpler if you leave the names alone for now.
  3753.  
  3754.           Each file which can be displayed to the user ends with the
  3755.           extension .BBS.  However, you will not be working directly with
  3756.           these files; just like the *.CTL files, display files need to be
  3757.           compiled before they can be displayed.  Although it is possible
  3758.           to directly enter text into the *.BBS file, it is usually much
  3759.           easier to edit the "source code" which contained in the .MEC
  3760.           file.
  3761.  
  3762.           "MEC" is an acronym which stands for 'Maximus Embedded Commands'. 
  3763.           However, if you really have a burning urge to insert compiled
  3764.           MECCA codes directly into a .BBS file, a list of the MECCA codes
  3765.           and their translations can be found in the MECCA language
  3766.           reference, in the Maximus Technical Reference Manual.
  3767.  
  3768.           Two of the advantages to using MECCA (as opposed to simply
  3769.           creating files with ANSI graphics) are:
  3770.  
  3771.           1)   You can imbed user- or system-specific information into any
  3772.                screen displayed to the user, which gives your BBS a
  3773.                personal touch.
  3774.  
  3775.           2)   Secondly, MECCA allows you to directly enter colour tokens
  3776.                and cursor controls.  The advantage to this is that Maximus
  3777.                will STRIP OUT these colour and cursor controls for callers
  3778.                who do not support them, which makes the *.ANS and *.ASC
  3779.                kludges of other BBS programs unnecessary.  Only one file is
  3780.                needed for any given screen, and Maximus will convert it
  3781.                on-the-fly for callers with or without ANSI graphics, with
  3782.                or without the ability to display IBM graphics characters,
  3783.                or any combination of the above.  This greatly reduces the
  3784.                time required to maintain your BBS, and it saves disk space
  3785.                too.
  3786.  
  3787.  
  3788.                    Maximus 2.02 System Operations Manual - Page 66
  3789.  
  3790.  
  3791.  
  3792.           A *.MEC file is composed of straight text, plus some optional
  3793.           "embedded commands".  If you want to see an actual *.MEC file,
  3794.           start up your text editor, and load the file
  3795.           '\MAX\MISC\NEWUSER2.MEC'.  As you can see, the file is mainly
  3796.           composed of straight ASCII text, but with a few special commands
  3797.           inserted in, mainly to control colour and to perform special
  3798.           functions such as displaying the user's name.
  3799.  
  3800.           Generally speaking, anything in a *.MEC file which is NOT inside
  3801.           a pair of square brackets is treated as straight text, and is
  3802.           therefore displayed to the user without alteration.  Anything
  3803.           which IS enclosed in square brackets is called a 'token', and is
  3804.           interpreted specially by Maximus.  Tokens have various functions,
  3805.           which can range from changing the colour of the text, to running
  3806.           an external *.EXE or *.COM program, to invoking the internal
  3807.           mail- checker
  3808.  
  3809.           Although you can see many MECCA tokens in use in the distribution
  3810.           \MAX\MISC\*.MEC files, a complete list of these tokens is
  3811.           available in the MECCA documentation, in the Maximus Technical
  3812.           Reference manual.  A complete walkthrough to creating a MECCA
  3813.           source file is given in that same documentation, so you should at
  3814.           least read the first few pages of that section.
  3815.  
  3816.           Once you have finished creating or modifying a *.MEC file, you
  3817.           must then compile it using MECCA, the Maximus Embedded Command
  3818.           Compiler (Advanced).  Compiling a file with MECCA is easy. 
  3819.           Simply type in the command 'MECCA <filename>', where <filename>
  3820.           is the name of the *.MEC file you wish to compile.  For example,
  3821.           to compile the file called 'APPLIC.MEC' into the file called
  3822.           'APPLIC.BBS', type in 'MECCA APPLIC'.  MECCA will then compile
  3823.           the specified file, and warn you if you made any errors.
  3824.  
  3825.           It is also a good idea to test your creations before allowing
  3826.           your users to log on.  Chances are that some of your compiled
  3827.           *.BBS files will have problems, so users might get stuck in an
  3828.           endless loop (or something equally embarrassing).  The Oracle
  3829.           utility will allow you to view *.BBS files off-line without
  3830.           having to start up a local Maximus session.  Please see the
  3831.           section on Oracle for more information.
  3832.  
  3833.  
  3834.  
  3835.  
  3836.  
  3837.  
  3838.  
  3839.  
  3840.  
  3841.  
  3842.  
  3843.                    Maximus 2.02 System Operations Manual - Page 67
  3844.  
  3845.  
  3846.  
  3847.  
  3848.           Step 12:  Customizing Msg/File Areas
  3849.  
  3850.           The next step in customizing your bulletin board system is to set
  3851.           up your own message and file areas.  Although the Maximus
  3852.           distribution kit came pre-configured with three message and three
  3853.           file areas, you will probably want to expand beyond this,
  3854.           particularly if you are a member of FidoNet and carry a number of
  3855.           EchoMail conferences.
  3856.  
  3857.           The first thing you should know is that all message areas are
  3858.           defined in MSGAREA.CTL, and file areas are defined in
  3859.           FILEAREA.CTL.  Both message and file areas have 9-character area
  3860.           "names", so you can have an unlimited number of message and file
  3861.           areas, in theory.  However, it is usually a good idea to start
  3862.           with a small number of areas, and then create new ones only as
  3863.           the need arises.
  3864.  
  3865.           Each area definition in both MSGAREA.CTL and FILEAREA.CTL begins
  3866.           with an 'Area <area_no>' line and ends with an 'End Area' line. 
  3867.           Everything between those lines pertains to that specific area
  3868.           only.  <area_no> specifies the area 'number' that is being
  3869.           defined.  Max supports alphanumeric area "numbers" up to nine
  3870.           characters long; area names such "CHATTER" and "HELP" are
  3871.           acceptable, as are numbers such as "1", "2" and "3".  You can
  3872.           even mix the two, such as "SYSOP249".
  3873.  
  3874.           Inside each area definition are a number of keywords which
  3875.           describe that area.  There are many advanced options available,
  3876.           but only a small subset of those are required for a basic
  3877.           configuration.
  3878.  
  3879.           Remember that message areas are defined in MSGAREA.CTL, and file
  3880.           areas are defined in FILEAREA.CTL.  It is possible to mix and
  3881.           match the two, but your system will be much easier to handle if
  3882.           the message and file areas are separated into two different
  3883.           control files.
  3884.  
  3885.  
  3886.  
  3887.           Options in MSGAREA.CTL
  3888.  
  3889.  
  3890.  
  3891.  
  3892.  
  3893.  
  3894.  
  3895.  
  3896.  
  3897.  
  3898.                    Maximus 2.02 System Operations Manual - Page 68
  3899.  
  3900.  
  3901.  
  3902.           MsgAccess <priv>
  3903.  
  3904.                This statement defines the access level that a user must
  3905.                possess to access this message area.
  3906.  
  3907.           MsgInfo <desc>
  3908.  
  3909.                This statement tells Maximus what to describe this message
  3910.                area as to the user.
  3911.  
  3912.           Local <path>
  3913.           EchoMail <path>
  3914.           Matrix <path>
  3915.  
  3916.                Depending on what type of message area this is, you will use
  3917.                ONE of the above three statements to tell Maximus the type
  3918.                of messages that are in this area and in what subdirectory
  3919.                the messages are located.  The area type can be LOCAL
  3920.                (Messages entered in this area stay on your system alone.),
  3921.                ECHOMAIL (Messages entered in this type of area are
  3922.                broadcast to other systems who are participating in the
  3923.                EchoMail conference.), or MATRIX.  (Messages entered in this
  3924.                area are sent directly to the destination node, sometimes
  3925.                referred to as 'NetMail'.)  <path> specifies the directory
  3926.                in which the messages are located.  Note:  Each message area
  3927.                must have its own separate subdirectory!  Yes, that is
  3928.                correct.  You must have a separate subdirectory for each
  3929.                message area, just as you must have a separate subdirectory
  3930.                for each file area.  SILT will create this directory for you
  3931.                if it does not already exist.
  3932.  
  3933.           Private Only
  3934.           Public and Private
  3935.           Public Only
  3936.           Read-Only
  3937.  
  3938.                Again, you can use only one of these four statements in a
  3939.                given message area.  These commands tell Maximus which type
  3940.                of messages to allow users to enter in this area.  The first
  3941.                three statements perform as expected.  Users may enter only
  3942.                private messages, they may be given the option of entering
  3943.                either private messages or public messages, or they may
  3944.                enter only public messages.  For most users, a read-only
  3945.                message area means that they cannot enter any messages. 
  3946.                Instead, they can only read existing messages.  This is
  3947.                useful for those sysops who want to set up a message area in
  3948.                which he/she can post bulletins for users to read. 
  3949.                Obviously, there must be some way for messages to be
  3950.                entered, or users would have nothing to read. Users with a
  3951.  
  3952.  
  3953.                    Maximus 2.02 System Operations Manual - Page 69
  3954.  
  3955.  
  3956.  
  3957.                with a privilege level of at least AsstSysOp are permitted
  3958.                to enter messages in read-only areas.  Users below AsstSysOp
  3959.                will receive the message, 'This is a read-only area', and
  3960.                Maximus will not allow them to enter a message.
  3961.  
  3962.           MsgName <tag>
  3963.  
  3964.                THIS IS ONLY REQUIRED FOR ECHOMAIL MESSAGE AREAS:
  3965.  
  3966.                This keyword tells Maximus what the 'echo tag' of the
  3967.                current message area is.  This tag should be the same as the
  3968.                one which you have defined for this area in the control file
  3969.                for your EchoMail utility, usually called AREAS.BBS.  For
  3970.                example, 'MUFFIN' is the echo tag of the Maximus SysOp
  3971.                support echo.
  3972.  
  3973.  
  3974.           Options in FILEAREA.CTL
  3975.  
  3976.  
  3977.           FileAccess <priv>
  3978.  
  3979.                This statement defines the access level that a user must
  3980.                possess to access this file area.
  3981.  
  3982.           FileInfo <desc>
  3983.  
  3984.                This statement tells Maximus how to describe this file area
  3985.                to the user.  You can add some descriptive comments if you
  3986.                like, so long as all of the text will fit on one line.  For
  3987.                example, the <desc> could be:  "General purpose utilities".
  3988.  
  3989.           Download <path>
  3990.  
  3991.                This statement defines the subdirectory in which the files
  3992.                for this file area are contained.  In other words, this is
  3993.                where users will be able to download files from.
  3994.  
  3995.           Upload <path>
  3996.  
  3997.                This statement defines the subdirectory in which uploads for
  3998.                this file area will be placed.  You have two options for
  3999.                defining an upload path:
  4000.  
  4001.                *    Set it to the same subdirectory as the download path. 
  4002.                     This means that users should be in the correct area
  4003.                     when they upload files, since the file will be
  4004.                     available for download from the specified area as soon
  4005.                     as the user finishes uploading.
  4006.  
  4007.  
  4008.                    Maximus 2.02 System Operations Manual - Page 70
  4009.  
  4010.  
  4011.  
  4012.                *    Set ALL upload paths in ALL file areas to point to the
  4013.                     DOWNLOAD path for area 0, which is normally accessible
  4014.                     by only the sysop.  This is the most secure option,
  4015.                     since it allows the sysop to check files which are
  4016.                     uploaded before they are put on-line.  Only after the
  4017.                     sysop has checked the file out and Hurled it to the
  4018.                     appropriate area is the file available for download by
  4019.                     users.  This also means that users can upload a file of
  4020.                     any type anywhere and not have to worry about getting
  4021.                     it in the correct area, since there is only one area
  4022.                     for uploads.
  4023.  
  4024.           Note!  By default, all log-off comments will be placed in message
  4025.           area 1.  However, if you wish to change the comment area, you can
  4026.           edit the "Comment Area" string in SESSION section of MAX.CTL.
  4027.  
  4028.           One last reminder.  Do not forget to recompile your control files
  4029.           with SILT after you make any changes!
  4030.  
  4031.  
  4032.  
  4033.  
  4034.  
  4035.  
  4036.  
  4037.  
  4038.  
  4039.  
  4040.  
  4041.  
  4042.  
  4043.  
  4044.  
  4045.  
  4046.  
  4047.  
  4048.  
  4049.  
  4050.  
  4051.  
  4052.  
  4053.  
  4054.  
  4055.  
  4056.  
  4057.  
  4058.  
  4059.  
  4060.  
  4061.  
  4062.  
  4063.                    Maximus 2.02 System Operations Manual - Page 71
  4064.  
  4065.  
  4066.  
  4067.  
  4068.           Step 13:  Maintaining File Areas
  4069.  
  4070.           Although message areas are easy to create (by simply adding the
  4071.           appropriate area definition to MSGAREA.CTL), file areas require a
  4072.           bit more maintenance.  Not only do you still need to create the
  4073.           area definition, but you also need to create a listing of files
  4074.           which are available for download in each file area.
  4075.  
  4076.           If you have no files to go into a particular area, you do not
  4077.           have to do anything.  Maximus will create a file catalog as
  4078.           needed when a user uploads a file.
  4079.  
  4080.  
  4081.           Creating File Listings
  4082.  
  4083.           If you already have some files that you would like to place in a
  4084.           certain file area, setting up that area is a bit more involved. 
  4085.           For starters, do a CD to the DOWNLOAD directory for that file
  4086.           area, as you specified it in FILEAREA.CTL.  From the download
  4087.           directory, just copy in all of the files that you wish to have in
  4088.           that file area.
  4089.  
  4090.           Once you have done that, to create the initial file catalog,
  4091.           simply type in the following command at the DOS or OS/2 command
  4092.           prompt:
  4093.  
  4094.                FOR %F IN (*.*) DO ECHO %F >> FILES.BBS
  4095.  
  4096.           You should see a bit of disk and screen activity as the file
  4097.           catalog is created for you.  Although this creates the file
  4098.           names, you are not done yet.  Next, load up an ASCII text editor,
  4099.           and load in FILES.BBS.  Inside this file, you should see a list
  4100.           of the files in the directory.  If you wish to add a comment for
  4101.           a particular file, you can just add one or more spaces after the
  4102.           filename, and insert your comment there.  (You can use up to
  4103.           forty-eight characters if you wish to keep the comment on one
  4104.           line.  If the comment is any longer, then Maximus will
  4105.           automatically wordwrap it onto the next line.  You can make the
  4106.           comment as long as you want, up to 255 characters in length.)
  4107.  
  4108.           Here are the contents of a sample FILES.BBS for a hypothetical
  4109.           file area:
  4110.  
  4111.           TEST.ZIP      This is a text file
  4112.           ABCDEFGH.TXT  This is another interesting text file
  4113.           ACKTHPPT.ZIP  A digitized Bloom County comic strip
  4114.  
  4115.  
  4116.  
  4117.  
  4118.                    Maximus 2.02 System Operations Manual - Page 72
  4119.  
  4120.  
  4121.  
  4122.           If you want to add files to your catalog after performing the
  4123.           initial 'FOR %F' command, you can simply use your text editor to
  4124.           place the filename on a new line of FILES.BBS, followed by the
  4125.           description.  Similarly, to delete a file from the catalog, just
  4126.           delete the line containing the file entry you wish to remove. 
  4127.           You will also need to delete the actual file from the
  4128.           subdirectory.
  4129.  
  4130.           When using the default 'File Date Automatic' setting in the
  4131.           control file, Maximus will automatically place the file size and
  4132.           date beside the filename, in addition to adding a bit of colour
  4133.           to the catalog.
  4134.  
  4135.           In addition, you can have files selected for "free download
  4136.           bytes" (does not count against user's download limit), "free
  4137.           download time" (does not count against user's time limit), or
  4138.           both.  Before a file's description, place a slash and a flag
  4139.           character.  For a free time download, use "/t".  For a free bytes
  4140.           download, use "/b".  For both free time and bytes, use "/tb".
  4141.  
  4142.           For example, to ensure that the Maximus 2.00 distribution files
  4143.           do not count against the user's download quota, use the
  4144.           following:
  4145.  
  4146.                MAX200-1.LZH /b This is Max 2.00!
  4147.  
  4148.           If you want to count the download against the user's byte total
  4149.           (but not the user's time limit), the following would do:
  4150.  
  4151.                MAX200-1.LZH /t This is Max 2.00!
  4152.  
  4153.           Similarly, if you want both free time and bytes to be given to
  4154.           the user, the following also works:
  4155.  
  4156.                MAX200-1.LZH /tb This is Max 2.00!
  4157.  
  4158.           Finally, you may add comments to the FILES.BBS listing which are
  4159.           not specifically related to one file.  If the first character on
  4160.           a line is a dash or a space, Maximus will treat the line as a
  4161.           comment and display it to the user.  All of the usual *.BBS file
  4162.           colours and tokens are acceptable.  If the first character on the
  4163.           line is a dash, the colour will be set to white before displaying
  4164.           the line.  If the first character is a space, the colour will be
  4165.           left alone (usually cyan).
  4166.  
  4167.  
  4168.  
  4169.  
  4170.  
  4171.  
  4172.  
  4173.                    Maximus 2.02 System Operations Manual - Page 73
  4174.  
  4175.  
  4176.  
  4177.           Global Downloading and Dupe Checking
  4178.  
  4179.           If you want to enable global downloading, upload dupe checking,
  4180.           and the fast locate function, you must use a compiled file
  4181.           database (as created by FB.EXE).
  4182.  
  4183.           Global downloading allows users to download a file from an area
  4184.           other than the current area.  For example, if a file in area 10
  4185.           is called QWERTY.LZH, a user could enter "d;qwerty.lzh" from area
  4186.           1 and successfully download that file.
  4187.  
  4188.           Upload dupe checking tells Max to check for duplicate file
  4189.           uploads.  Whenever a user uploads a file, Max will check the
  4190.           compiled file database to see if that file already exists in one
  4191.           of your other file areas.  If it does, Max will abort the upload
  4192.           and display a short message to the user.
  4193.  
  4194.           The fast locate command simply makes the Locate and Newfiles
  4195.           commands much faster.  The search times on a large system will be
  4196.           sped up by several magnitudes, especially if you have a CD-ROM or
  4197.           WORM available to users.  The fast locate command will be
  4198.           automatically used if a compiled file database exists in the Max
  4199.           root directory.
  4200.  
  4201.           To create a file area database (and to use all of the above
  4202.           features), you must run a program called FB (Filebase Build).  FB
  4203.           scans the FILES.BBS directories in each file area, compiles it
  4204.           into a flat binary file, and creates a sorted index at the end. 
  4205.           Max can use this index to process global downloads and dupe
  4206.           checking; the flat binary files are used for the Locate and
  4207.           Newfiles commands.
  4208.  
  4209.           Creating a compiled file database is easy; after making any
  4210.           change to the file areas (whether it be adding, deleting,
  4211.           receiving a TICK file, or even modifying a file description), the
  4212.           following command should be run from the Max root directory:
  4213.  
  4214.                FB
  4215.  
  4216.           This tells FB to scan all of the file areas listed in AREA.DAT. 
  4217.           This command creates all of the binary and index files, and so as
  4218.           long as you remember to run FB, global downloading and upload
  4219.           dupe checking can be used with no special effort.  (You may need
  4220.           to enable upload dupe checking through the "Upload Check Dupe"
  4221.           keyword in the SESSION section of MAX.CTL.)
  4222.  
  4223.           If you have a large system, running FB in this manner can take a
  4224.           long time (especially if you make a lot of small changes).  For
  4225.           information on compiling only one or two areas at a time, or for
  4226.  
  4227.  
  4228.                    Maximus 2.02 System Operations Manual - Page 74
  4229.  
  4230.  
  4231.  
  4232.           using an area data file other than AREA.DAT, please see the
  4233.           section on FB in this manual.
  4234.  
  4235.  
  4236.  
  4237.  
  4238.  
  4239.  
  4240.  
  4241.  
  4242.  
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.  
  4249.  
  4250.  
  4251.  
  4252.  
  4253.  
  4254.  
  4255.  
  4256.  
  4257.  
  4258.  
  4259.  
  4260.  
  4261.  
  4262.  
  4263.  
  4264.  
  4265.  
  4266.  
  4267.  
  4268.  
  4269.  
  4270.  
  4271.  
  4272.  
  4273.  
  4274.  
  4275.  
  4276.  
  4277.  
  4278.  
  4279.  
  4280.  
  4281.  
  4282.  
  4283.                    Maximus 2.02 System Operations Manual - Page 75
  4284.  
  4285.  
  4286.  
  4287.  
  4288.           Step 14:  Customizing Menus
  4289.  
  4290.           Max's menus are completely redefinable and can become difficult
  4291.           to manipulate.  If you are just starting out, leave the menus
  4292.           alone until you become more comfortable with Maximus.  However,
  4293.           even novices can change the access levels of particular commands
  4294.           in MENUS.CTL.  The access level is usually located in the second
  4295.           or third column of each menu option.  The only other "safe" field
  4296.           is the "Command as it appears to user" option.  This command will
  4297.           be shown on the user's screen for NOVICE-level menus.  Remember,
  4298.           the FIRST character in the command will be used to activate that
  4299.           option, so make sure that no more than one of your commands uses
  4300.           a given letter as its first character.  (For example, do not use
  4301.           both "F)ile List" and "F)ind File" on the same menu.)
  4302.  
  4303.           The last thing which is safe to play around with is the
  4304.           'MenuFile' option.  This option tells Maximus to display a
  4305.           customized *.BBS file, as opposed to generating a canned file. 
  4306.           This will allow you to completely customize your BBS and make it
  4307.           look different from any other.  Please see the section entitled
  4308.           'Using Custom Menus' for more information on this topic.
  4309.  
  4310.  
  4311.  
  4312.  
  4313.  
  4314.  
  4315.  
  4316.  
  4317.  
  4318.  
  4319.  
  4320.  
  4321.  
  4322.  
  4323.  
  4324.  
  4325.  
  4326.  
  4327.  
  4328.  
  4329.  
  4330.  
  4331.  
  4332.  
  4333.  
  4334.  
  4335.  
  4336.  
  4337.  
  4338.                    Maximus 2.02 System Operations Manual - Page 76
  4339.  
  4340.  
  4341.  
  4342.  
  4343.           Step 15:  Configuring the QWK Mail Packer
  4344.  
  4345.           Maximus supports a built-in QWK offline mail packer.  This
  4346.           feature allows callers to log on, pack up messages from one or
  4347.           more message areas, and download a compressed mail bundle for
  4348.           off-line reading and reply.  This packer is fully integrated with
  4349.           the main BBS, so the packer will automatically adjust itself as
  4350.           areas are added to or deleted from your system.
  4351.  
  4352.           All of the information for the off-line reader is stored in
  4353.           READER.CTL.  Your next task is load this file into your text
  4354.           editor, since several keywords need to be modified.
  4355.  
  4356.           1)   First of all, you will need to modify the "Packet Name"
  4357.                keyword.  This keyword specifies the filename to use when
  4358.                sending QWK packets to your users, minus the ".QWK"
  4359.                extension.  This name should be eight or fewer characters,
  4360.                case insensitive, with no spaces.  Try to make the name
  4361.                describe your BBS in some way; an abbreviation of your BBS
  4362.                name is normally used.  For example, a BBS called "Fowl
  4363.                Weather Post" might use a packet name of "FOWLPOST", and a
  4364.                BBS called "123 Systems Inc." might use a packet name of
  4365.                "123SYS".
  4366.  
  4367.           2)   Second, you should modify the "Phone Number" keyword to
  4368.                reflect your actual phone number.  Maximus does not use this
  4369.                information, but your system's phone number is normally
  4370.                placed in the .QWK download packets.  The phone number
  4371.                format given in the control file is suggested, even if you
  4372.                live in another country, since some external readers depend
  4373.                on this number being in a certain format.  Unfortunately,
  4374.                this is a problem with the readers, so there's nothing that
  4375.                Maximus can do about it.
  4376.  
  4377.           3)   Finally, you may want to customize the "Max Mesasges" limit. 
  4378.                If you run a busy system and you want to restrict callers
  4379.                from downloading more than 200 messages at a time, you can
  4380.                set a maximum here.  In the distribution control file, a
  4381.                maximum of 600 messages is set.  To completely disable the
  4382.                maximum, comment out the "Max Messages" keyword.
  4383.  
  4384.           That's all there is to it!  Beyond the initial configuration, the
  4385.           QWK packer is completely self-maintaining.  No extra maintenance
  4386.           is required.  However, if you would like to add some features to
  4387.           your mail packer (such as bulletins and new file lists), please
  4388.           see the section entitled "QWK MAIL PACKER".
  4389.  
  4390.  
  4391.  
  4392.  
  4393.                    Maximus 2.02 System Operations Manual - Page 77
  4394.  
  4395.  
  4396.  
  4397.  
  4398.           Step 16:  Miscellaneous Information
  4399.  
  4400.           You have now completed the installation procedure for Maximus. 
  4401.           Although you are now officially finished, there are a few things
  4402.           that you should keep in mind:
  4403.  
  4404.           For users of *.MSG areas:  A renumbering utility is required.  If
  4405.           you carry any EchoMail conferences, a renumbering utility will be
  4406.           especially crucial.  Maximus comes bundled with a program caller
  4407.           MR; this will automatically delete, renumber and link messages
  4408.           based on information given in MSGAREA.CTL.  MR does not use low-
  4409.           level disk calls, so it is safe to use on all systems.  For more
  4410.           information on MR, please see the Maximus Utility Documentation.
  4411.  
  4412.           For users of Squish areas:  Although Squish normally handles
  4413.           renumbering on-the-fly, you may need to use the "SQPACK" utility
  4414.           on a semi-frequent basis.  (Typical systems only need to run
  4415.           SQPACK once a week, but large systems may need to use SQPACK on a
  4416.           daily basis.)  Squish areas gradually develop small holes over a
  4417.           period of time, and the SQPACK program can be used to remove
  4418.           these holes.  In addition, if you are performing renumbering by
  4419.           date, you must use SQPACK, since renumbering by date cannot be
  4420.           performed on-the-fly.  SQPACK is part of Max's companion mail
  4421.           processor, SquishMail.  The SquishMail package includes a number
  4422.           of other useful utilities (such as diagnostic and repair aids for
  4423.           Squish-style areas), so getting a copy of SQSH_*.* is a good
  4424.           idea.
  4425.  
  4426.           Finally, if you are having trouble installing Maximus, chances
  4427.           are that you have not followed these instructions to the letter. 
  4428.           Try reading through the installation instructions once more to
  4429.           see if you forgot anything.
  4430.  
  4431.  
  4432.  
  4433.  
  4434.  
  4435.  
  4436.  
  4437.  
  4438.  
  4439.  
  4440.  
  4441.  
  4442.  
  4443.  
  4444.  
  4445.  
  4446.  
  4447.  
  4448.                    Maximus 2.02 System Operations Manual - Page 78
  4449.  
  4450.  
  4451.  
  4452.                             MAXIMUS UTILITY DOCUMENTATION
  4453.  
  4454.  
  4455.           ACCEM:  MECCA Decompiler
  4456.  
  4457.           ACCEM does the reverse of what the MECCA utility does: it takes a
  4458.           compiled .BBS file, and converts it back to a human- readable
  4459.           .MEC file.  This can be useful if you have lost the source for
  4460.           one of your .BBS display files, or if you are trying to change a
  4461.           compiled .BBS file which someone else has given you.
  4462.  
  4463.           After running ACCEM on a .BBS file, you can freely edit the
  4464.           resulting .MEC file, and recompile it as you wish.  ACCEM can
  4465.           convert a .BBS file back to the complete .MEC file.  The .MEC
  4466.           file created with ACCEM should be identical to the original .MEC
  4467.           file, with one small exception: since label names are not stored
  4468.           in the .BBS file, MECCA will simply convert these into numeric
  4469.           labels in the form of '/L0', '/L1', '/L2', etc.  However, the
  4470.           reverse-engineered .MEC file will still compile correctly, and
  4471.           after compiling, the output from the new .MEC file should be
  4472.           identical to the original .BBS file.
  4473.  
  4474.           The format for ACCEM is:
  4475.  
  4476.                ACCEM <infile> [outfile] [-s]
  4477.  
  4478.           <infile> is the name of the .BBS file to convert.  If no
  4479.           extension is given, then ACCEM will automatically use an
  4480.           extension of .BBS.
  4481.  
  4482.           [outfile] is the name of the .MEC file to write to.  If no
  4483.           extension is given, or even if [outfile] is omitted, then ACCEM
  4484.           will default to the <infile> filename, but using an extension of
  4485.           .MEC.
  4486.  
  4487.           [-s] tells ACCEM to split lines which are over 100 characters. 
  4488.           Using this will make ACCEM place an empty brace at the end of
  4489.           each line, thereby limiting the length of lines in the .MEC file,
  4490.           but without affecting the .BBS output.  This is useful if you are
  4491.           decompiling a .BBS file with some very long lines, and if your
  4492.           editor can only display a limited number of columns.
  4493.  
  4494.           For example, to convert TEST.BBS to TEST.MEC, all of the commands
  4495.           following would work equally well:
  4496.  
  4497.  
  4498.  
  4499.  
  4500.  
  4501.  
  4502.  
  4503.                    Maximus 2.02 System Operations Manual - Page 79
  4504.  
  4505.  
  4506.  
  4507.                ACCEM TEST
  4508.                     or
  4509.                ACCEM TEST.BBS
  4510.                     or
  4511.                ACCEM TEST.BBS TEST
  4512.  
  4513.           If one wanted to split lines over 100 characters in length, the
  4514.           following would work, too:
  4515.  
  4516.                ACCEM TEST -s
  4517.                ACCEM TEST.BBS -s
  4518.                ACCEM TEST.BBS TEST -s
  4519.  
  4520.  
  4521.  
  4522.  
  4523.  
  4524.  
  4525.  
  4526.  
  4527.  
  4528.  
  4529.  
  4530.  
  4531.  
  4532.  
  4533.  
  4534.  
  4535.  
  4536.  
  4537.  
  4538.  
  4539.  
  4540.  
  4541.  
  4542.  
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.  
  4549.  
  4550.  
  4551.  
  4552.  
  4553.  
  4554.  
  4555.  
  4556.  
  4557.  
  4558.                    Maximus 2.02 System Operations Manual - Page 80
  4559.  
  4560.  
  4561.  
  4562.  
  4563.           ANS2BBS/MEC:  ANSI to MEC conversion
  4564.  
  4565.           ANS2BBS and ANS2MEC are two programs which will process a file
  4566.           containing ANSI graphics, and convert it into a file displayable
  4567.           by Maximus.  ANS2BBS will convert a file containing ANSI graphics
  4568.           directly into a .BBS file, which can be immediately displayed by
  4569.           Maximus.  On the other hand, ANS2MEC will convert a file with
  4570.           ANSI graphics into a file containing MECCA commands, as opposed
  4571.           to the compiled AVATAR sequences which are generated when ANS2BBS
  4572.           is run.
  4573.  
  4574.           ANS2BBS is useful for a one-time translation, when you are sure
  4575.           that the output will look right.  ANS2MEC is useful if you wish
  4576.           to display a file containing ANSI graphics, but also want to add
  4577.           some special effects, such as customizing the screen with MECCA
  4578.           tokens, or adding menus.
  4579.  
  4580.           After running ANS2MEC and making any changes, the .MEC file must
  4581.           then be compiled into a .BBS file through MECCA, the Maximus
  4582.           Embedded Command Compiler.  Please refer to the MECCA command
  4583.           language reference (in the Maximus System Reference Manual) for
  4584.           more details on the operation of MECCA.
  4585.  
  4586.           The format for ANS2BBS (and ANS2MEC) is as follows:
  4587.  
  4588.                ANS2BBS <infile> [outfile]
  4589.                   or
  4590.                ANS2MEC <infile> [outfile]
  4591.  
  4592.           <infile> is the name of the input file which contains ANSI
  4593.           graphics.  If no filename extension is specified, then ".ANS"
  4594.           will be used by default.
  4595.  
  4596.           [outfile] is the name of the file to place ANS2BBS/ANS2MEC's
  4597.           output in.  If no output filename is specified, then ANS2BBS will
  4598.           add a '.BBS' extension to the input filename, and send the output
  4599.           to that file.  ANS2MEC will do similar, except it will use an
  4600.           extension of '.MEC' instead.
  4601.  
  4602.           Although ANS2BBS and ANS2MEC will try do the best job they can
  4603.           when converting an ANSI file, due to some ambiguities in the ANSI
  4604.           cursor-movement syntax, it is not always possible to correctly
  4605.           convert all ANSI graphics files.  ANS2BBS and ANS2MEC will
  4606.           particularly have problems with some 'highly-animated'
  4607.           screens,including some of TheDraw's alternate scanning modes,
  4608.           such as 'Diagonal', 'Gate', 'Squiggle', etc.  Maximus can handle
  4609.           almost all straight-through ANSI files, so unless you are using
  4610.           one of those scanning modes, you should not have any problems.
  4611.  
  4612.  
  4613.                    Maximus 2.02 System Operations Manual - Page 81
  4614.  
  4615.  
  4616.  
  4617.           However, once you have converted an ANSI screen, it is a good
  4618.           idea to put it in a place where Maximus can access it, and test
  4619.           it in local mode, or with the Oracle utility.  If the file did
  4620.           not convert correctly and has some formatting glitches, then you
  4621.           have two choices:
  4622.  
  4623.           *    If the file is animated, load the file using TheDraw, an
  4624.                excellent ANSI screen editor by Ian Davis, and turn off the
  4625.                animation by pressing Alt-J and then 'N' to convert the
  4626.                drawing to normal mode.  Then try ANS2BBS again, and hope it
  4627.                works.
  4628.  
  4629.           *    Convert the file using ANS2MEC, and try to edit the MECCA
  4630.                tokens to fix the problem, and then compile the .MEC file
  4631.                using MECCA.
  4632.  
  4633.           *    Leave the file as-is, and send straight ANSI codes to the
  4634.                caller.  Although it will not be viewable by AVATAR or TTY
  4635.                callers, and it will look icky if you have the 'Video IBM'
  4636.                statement enabled, it should work okay for remote ANSI
  4637.                callers, if you enclose the graphics inside '[colour]' and
  4638.                '[endcolour] tokens.
  4639.  
  4640.  
  4641.  
  4642.  
  4643.  
  4644.  
  4645.  
  4646.  
  4647.  
  4648.  
  4649.  
  4650.  
  4651.  
  4652.  
  4653.  
  4654.  
  4655.  
  4656.  
  4657.  
  4658.  
  4659.  
  4660.  
  4661.  
  4662.  
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.                    Maximus 2.02 System Operations Manual - Page 82
  4669.  
  4670.  
  4671.  
  4672.  
  4673.           CVTUSR:  User File Conversions
  4674.  
  4675.           CVTUSR is a utility which will allow you to convert foreign user
  4676.           files into a format Maximus can handle, from several other
  4677.           popular BBS programs.  In addition, CVTUSR is also capable of
  4678.           generating an Opus 1.10-style USER.DAT file (for use with
  4679.           external programs) FROM Maximus' own USER.BBS.
  4680.  
  4681.           The command-line format for CVTUSR is
  4682.  
  4683.                CVTUSR [[-x]...] 
  4684.  
  4685.           where valid switches are:
  4686.  
  4687.           -l and
  4688.           -m        These switches tell CVTUSR to reset the lastread
  4689.                     pointers in a Maximus-style USER.BBS.  This option is
  4690.                     normally only used to fix cross-linked lastread
  4691.                     pointers, so it should only be used when "Lastread ptr
  4692.                     xlinked" error message appear in the log.  This
  4693.                     function may reset the lastread pointers for some or
  4694.                     all users, but it will correct any crosslinked
  4695.                     pointers.  Both -l and -m function identically.
  4696.  
  4697.           -o110     This switch tells CVTUSR that you are converting an
  4698.                     Opus 1.10-style USER.DAT to a Maximus-style USER.BBS. 
  4699.                     This procedure will convert almost all of the Opus 1.10
  4700.                     fields, with the exception of the expiry dates,
  4701.                     personal welcome screens, and any utility-specific
  4702.                     fields which may be stored in the user file.  Your old
  4703.                     USER.DAT is NOT overwritten by this procedure, so you
  4704.                     do not need to make a copy of it.
  4705.  
  4706.           -q        This switch tells CVTUSR to convert a QuickBBS or RA-
  4707.                     style USERS.BBS to a Maximus USER.BBS.  This conversion
  4708.                     function is not as complete as some of the others; it
  4709.                     will leave out things such as ANSI graphics and "More
  4710.                     [Y,n]?" prompting.  However, the next time the user
  4711.                     logs on, Maximus will ask for all the information which
  4712.                     could not be converted, so the loss is minimal.
  4713.  
  4714.  
  4715.  
  4716.  
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.  
  4723.                    Maximus 2.02 System Operations Manual - Page 83
  4724.  
  4725.  
  4726.  
  4727.                     When converting QBBS security levels, CVTUSR will use
  4728.                     the following conversion system:
  4729.  
  4730.                     QBBS User Level          Max Priv Level
  4731.  
  4732.                     100-32000                SysOp
  4733.                      90-99                   AsstSysOp
  4734.                      80-89                   Clerk
  4735.                      70-79                   Extra
  4736.                      60-69                   Favoured
  4737.                      50-59                   Privil
  4738.                      40-49                   Worthy
  4739.                      20-39                   Normal
  4740.                       1-19                   Disgrace
  4741.  
  4742.           -x110     This switch CVTUSR to convert the Maximus-style
  4743.                     USER.BBS to an Opus 1.10-style USER.DAT.  CVTUSR will
  4744.                     translate all of Maximus' fields into the equivalent
  4745.                     Opus 1.10 fields, and will also attempt to store some
  4746.                     Maximus-specific information in some "spare" fields. 
  4747.                     This means that it MAY be possible to convert the
  4748.                     Maximus USER.BBS to the Opus USER.DAT, run a program
  4749.                     which modifies the Opus version of the user file, and
  4750.                     convert it back.  Although this theoretically should
  4751.                     work without problems, it is not advised, and doing so
  4752.                     may cause some fields to be lost in the Maximus portion
  4753.                     of the user file.
  4754.  
  4755.           -n        This flag tells CVTUSR to convert an older Maximus 1.0x
  4756.                     USER.BBS to a Maximus 2.0x USER.BBS file.
  4757.  
  4758.           -s        This flag tells CVTUSR to swap the 'alias' and 'name'
  4759.                     fields in a Maximus 2.0x USER.BBS file.  This function
  4760.                     is used to accommodate the changes made in the alias
  4761.                     system in Maximus 2.00 and above.
  4762.  
  4763.  
  4764.  
  4765.  
  4766.  
  4767.  
  4768.  
  4769.  
  4770.  
  4771.  
  4772.  
  4773.  
  4774.  
  4775.  
  4776.  
  4777.  
  4778.                    Maximus 2.02 System Operations Manual - Page 84
  4779.  
  4780.  
  4781.  
  4782.  
  4783.           EDITCAL:  Call Fudging Utility
  4784.  
  4785.           EditCal is a small utility which was written to dummy up the
  4786.           'number of callers' count contained in BBSTATxx.BBS.  This
  4787.           program is useful if you have recently changed from another BBS
  4788.           package, and want to set the caller count to reflect the actual
  4789.           number of callers to your system.
  4790.  
  4791.           The command-line format for EditCal is:
  4792.  
  4793.                EDITCAL <task_num> [num_calls]
  4794.  
  4795.           <task_num> should indicate the task number whose caller counter
  4796.           you wish to set.  If you are running only one line, then use 0
  4797.           for <task_num>.
  4798.  
  4799.           [num_calls] should indicate the new number-of-calls variable you
  4800.           wish to set for the specified task.  If you do not specify this
  4801.           parameter, then EditCal will simply display the number of callers
  4802.           for the specified task number, without changing anything.
  4803.  
  4804.  
  4805.  
  4806.  
  4807.  
  4808.  
  4809.  
  4810.  
  4811.  
  4812.  
  4813.  
  4814.  
  4815.  
  4816.  
  4817.  
  4818.  
  4819.  
  4820.  
  4821.  
  4822.  
  4823.  
  4824.  
  4825.  
  4826.  
  4827.  
  4828.  
  4829.  
  4830.  
  4831.  
  4832.  
  4833.                    Maximus 2.02 System Operations Manual - Page 85
  4834.  
  4835.  
  4836.  
  4837.  
  4838.           FB:  File Database Compiler
  4839.  
  4840.           FB is the Maximus File Database compiler.  FB compiles the ASCII
  4841.           listings in FILES.BBS into a format which can be used by the
  4842.           global downloading routines, upload dupe checker, and the fast
  4843.           Locate command.  FB is not required, since Max can use FILES.BBS
  4844.           directly, but you'll be missing out on a lot of the new features
  4845.           if you do not use FB.
  4846.  
  4847.           WARNING!  FB can only be used for automatic file dating.  If you
  4848.           are using "File Date Manual", you should make sure to remove all
  4849.           file dates from FILES.BBS before running FB.  Using manual dating
  4850.           is much less of a necessity with FB anyway, since file sizes and
  4851.           dates are stored in the binary database.
  4852.  
  4853.           The command line format of FB is as follows:
  4854.  
  4855.                FB [[area_dat] [area...] [/u]]
  4856.  
  4857.           [area_dat] specifies the name of the area data file.  If no
  4858.           command line parameters are specified, FB will default to
  4859.           AREA.DAT in the current directory.
  4860.  
  4861.           [area...] is a list of zero or more area "numbers", as specified
  4862.           in the "Area <anum>" statement in FILEAREA.CTL.  If no area
  4863.           numbers are specified, FB will rebuild the entire file database. 
  4864.           Otherwise, FB will only process the file areas given.
  4865.  
  4866.           [/u] is the optional 'upload' switch.  This causes Maximus to
  4867.           scan the UPLOAD path of the specified file areas rather than the
  4868.           download path.  This parameter is used internally by Maximus in
  4869.           RUNFB.BAT (see below for more information).
  4870.  
  4871.           When compiling a file area, FB will parse FILES.BBS and create
  4872.           the following files in each file area:
  4873.  
  4874.                FILES.DAT A compiled version of each file's name, size,
  4875.                          timestamp, privilege level and flags.
  4876.  
  4877.                FILES.DMP A compiled version of each file description.
  4878.  
  4879.  
  4880.  
  4881.  
  4882.  
  4883.  
  4884.  
  4885.  
  4886.  
  4887.  
  4888.                    Maximus 2.02 System Operations Manual - Page 86
  4889.  
  4890.  
  4891.  
  4892.                FILES.IDX A sorted binary index of all files in the current
  4893.                          area.
  4894.  
  4895.           If you are using a FileList statement in FILEAREA.CTL, Max will
  4896.           simply chop off the file list's extension and add .DAT, .DMP and
  4897.           .IDX as appropriate.  For example, if you specified the following
  4898.           in FILEAREA.CTL:
  4899.  
  4900.                FileList    D:\AREA1.LST
  4901.  
  4902.           FB would then create files called D:\AREA1.DAT, D:\AREA1.DMP and
  4903.           D:\AREA1.IDX.  This allows owners of CD-ROMs to store all of the
  4904.           file area information in an alternate location.
  4905.  
  4906.           Max also supports a special feature for updating the file
  4907.           database after a file is uploaded.  After processing all of the
  4908.           files uploaded in a single U)pload command, Max will try to find
  4909.           a file called RUNFB.BAT (or RUNFB.CMD for OS/2) in the Max root
  4910.           directory.  After the upload, if this batch/command file is
  4911.           found, Max will execute it with the following parameters:
  4912.  
  4913.                RUNFB <area_dat> <areanum> -u
  4914.  
  4915.           where <area_dat> is the name of the current AREA.DAT file,
  4916.           <areanum> is the area into which the files were uploaded.  (-u
  4917.           specifies that FB should check the upload paths rather than the
  4918.           download paths.)
  4919.  
  4920.           In the default distribution, RUNFB.BAT looks like this:
  4921.  
  4922.                fb %1 %2 %3
  4923.  
  4924.           This causes RUNFB to automatically run FB, which causes the file
  4925.           database to be updated on the spot.  However, if you do not have
  4926.           enough memory to run FB in the BBS window, or if you do not wish
  4927.           to waste time by compiling the file database while the user is
  4928.           on-line, you can use the following in RUNFB instead:
  4929.  
  4930.                echo fb %1 %2 %3 >>do_fb.bat
  4931.  
  4932.           (OS/2 users should use 'do_fb.cmd' instead of 'do_fb.bat'.)
  4933.  
  4934.           The above command creates a log of file areas to update.  If you
  4935.           are using this deferred file database updating, you should insert
  4936.           the following command in your batch file after each caller:
  4937.  
  4938.           (DOS 3.0-3.2 only)
  4939.  
  4940.                if exist do_fb.bat command /c do_fb.bat
  4941.  
  4942.  
  4943.                    Maximus 2.02 System Operations Manual - Page 87
  4944.  
  4945.  
  4946.  
  4947.                del do_fb.bat
  4948.  
  4949.           (DOS 3.3 and above only)
  4950.  
  4951.                if exist do_fb.bat call do_fb.bat
  4952.                del do_fb.bat
  4953.  
  4954.           (OS/2 only)
  4955.  
  4956.                if exist do_fb.cmd call do_fb.cmd
  4957.                del do_fb.cmd
  4958.  
  4959.           These lines cause Max to perform all file database updating after
  4960.           the caller logs off, which saves on both memory and on-line time. 
  4961.           Make sure to select the command which is appropriate for your
  4962.           system and DOS revision, and make sure that it is run after EVERY
  4963.           caller, regardless of whether or not that caller entered NetMail,
  4964.           EchoMail, or no mail.
  4965.  
  4966.  
  4967.  
  4968.  
  4969.  
  4970.  
  4971.  
  4972.  
  4973.  
  4974.  
  4975.  
  4976.  
  4977.  
  4978.  
  4979.  
  4980.  
  4981.  
  4982.  
  4983.  
  4984.  
  4985.  
  4986.  
  4987.  
  4988.  
  4989.  
  4990.  
  4991.  
  4992.  
  4993.  
  4994.  
  4995.  
  4996.  
  4997.  
  4998.                    Maximus 2.02 System Operations Manual - Page 88
  4999.  
  5000.  
  5001.  
  5002.  
  5003.           MAID:  Language File Compiler
  5004.  
  5005.           MAID is Maximus Language File compiler.  MAID takes a language
  5006.           file source, such as ENGLISH.MAD, and turns it into a form usable
  5007.           by Maximus.  The language file support can be used to support
  5008.           non-foreign languages, or simply to change the prompts in the
  5009.           English version of Max.
  5010.  
  5011.           MAID reads the source language from a file called <langname>.MAD. 
  5012.           The distribution version of Maximus comes with one language file
  5013.           called ENGLISH.MAD.  The different files associated with language
  5014.           file processing area:
  5015.  
  5016.           <langname>.MAD:     The Maximus International Definitions file. 
  5017.                               This file contains the language "source". 
  5018.                               This file can be edited with an ordinary text
  5019.                               editor, and this file is used as the input
  5020.                               file for MAID.
  5021.  
  5022.           <langname>.LTF:     The Language Translation File.  This is the
  5023.                               compiled version of the <langname>.MAD file,
  5024.                               as produced by MAID.  This is the only file
  5025.                               that Max uses; if you do not want to change
  5026.                               the language source, feel free to delete the
  5027.                               <langname>.MAD file.
  5028.  
  5029.           ENGLISH.LTH:        The dynamic language include file for the C
  5030.                               language.  This is only required when
  5031.                               recompiling the source code.
  5032.  
  5033.           ENGLISH.H:          The static language include file for the C
  5034.                               language.  This is only required when
  5035.                               recompiling the source code.
  5036.  
  5037.           If you are planning on changing the language files, you must keep
  5038.           ENGLISH.MAD and ENGLISH.LTF as a minimum.  By default, the
  5039.           install program places language files in the \MAX\LANG directory.
  5040.  
  5041.           The command line format for MAID is as follows:
  5042.  
  5043.                MAID <langname> [-s] [-d]
  5044.  
  5045.           <langname> is the full path and name of the language file.  Do
  5046.           NOT include an extension; MAID will add the ".MAD" automatically.
  5047.  
  5048.           -s   Specifies that you want the static language include file to
  5049.                be generated.  This is only required when recompiling the
  5050.  
  5051.  
  5052.  
  5053.                    Maximus 2.02 System Operations Manual - Page 89
  5054.  
  5055.  
  5056.  
  5057.                source code.  The <langname>.LTH file is not created unless
  5058.                you use this switch.
  5059.  
  5060.           -d   Specifies that you want the dynamic language include file to
  5061.                be generated.  This is only required when recompiling the
  5062.                source code.  The <langname>.H file is not created unless
  5063.                you use this switch.
  5064.  
  5065.           If you wish to change the source in ENGLISH.MAD, you must be wary
  5066.           of three points: 
  5067.  
  5068.           1)   Make sure NOT to change the order of the statements within
  5069.                the file!  Disastrous consequences may result if the strings
  5070.                get out-of-sync.  You can add and delete blank lines or
  5071.                comments, but leave the order of the strings alone.
  5072.  
  5073.           2)   After changing the language file source, the file must be
  5074.                recompiled with MAID to create the .LTF version of the
  5075.                language.
  5076.  
  5077.           3)   After compiling the language file, you MUST recompile your
  5078.                .PRM file with SILT!  Since Max overlays strings in memory,
  5079.                Max needs to know how long your language files are; the
  5080.                summary of this information is stored in MAX.PRM.  SILT
  5081.                collects this information while compiling the .PRM file, so
  5082.                you can simply run SILT to create the language file.  If
  5083.                Maximus detects that the language file has been changed at
  5084.                start-up, it will print out "Old language <langname>: 
  5085.                recompile PRM file with SILT!" and exit.  It is vitally
  5086.                important that the .PRM file be recompiled after changing
  5087.                any of the language files.
  5088.  
  5089.           Finally, if you wish to create a modified language for other
  5090.           people to use, you can simply copy ENGLISH.* to MYLANG.* (or
  5091.           whatever you wish to call the language), and then add that
  5092.           language as a "Language MYLANG" statement in MAX.CTL.
  5093.  
  5094.           NOTE!  We are attempting to set up a "Maximus Language File
  5095.           Repository".  If you have written a Maximus language file for
  5096.           another language (or if you have done a take-off of the English
  5097.           language, such as JIVE, VALLEY, etc.), please upload a copy of
  5098.           the .MAD file to the author's BBS.  A special portion of the
  5099.           Maximus distribution area will be set up for alternate language
  5100.           files, acting as a  central location for obtaining new language
  5101.           files.  Language files are also welcome in SDSMAX, the Software
  5102.           Distribution System area dedicated to Maximus and related
  5103.           utilities.
  5104.  
  5105.  
  5106.  
  5107.  
  5108.                    Maximus 2.02 System Operations Manual - Page 90
  5109.  
  5110.  
  5111.  
  5112.  
  5113.           MAXPIPE:  OS/2 Redirection Utility
  5114.  
  5115.           MAXPIPE is an OS/2-only program used to redirect the I/O from
  5116.           command-line programs to the com port.  This is useful when
  5117.           spawning an OS/2 shell, or when running certain command-line
  5118.           driven programs.  (Maximus-OS/2 automatically calls MAXPIPE when
  5119.           spawning archivers to compress QWK packets.)
  5120.  
  5121.           MAXPIPE also provides a "watchdog" facility.  If carrier drops
  5122.           while the external program is active, MAXPIPE kills the running
  5123.           process and returns to Maixmus.
  5124.  
  5125.           The command-line format for MAXPIPE is:
  5126.  
  5127.                MAXPIPE <handle> <program> [args...]
  5128.  
  5129.           <handle> is the comm port handle, as generated by the "%P"
  5130.           external translation character.  If a handle of "0" is used,
  5131.           MAXPIPE will run in local mode.
  5132.  
  5133.           <program> is the name of the external program to be spawned. 
  5134.           Ensure to specify the full filename and path.
  5135.  
  5136.           [args...] are the optional arguments to pass to the external
  5137.           program.
  5138.  
  5139.           NOTE:  MAXPIPE works only with programs that use "stdin/stdout"
  5140.           style output.  Programs which attempt to access the screen using
  5141.           any of the PM or Vio() functions will not function correctly with
  5142.           MAXPIPE.
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.  
  5149.  
  5150.  
  5151.  
  5152.  
  5153.  
  5154.  
  5155.  
  5156.  
  5157.  
  5158.  
  5159.  
  5160.  
  5161.  
  5162.  
  5163.                    Maximus 2.02 System Operations Manual - Page 91
  5164.  
  5165.  
  5166.  
  5167.  
  5168.           MECCA:  Display File Compiler
  5169.  
  5170.           MECCA is a companion utility which will compile *.MEC input files
  5171.           into binary *.BBS files, which can then be displayed by Maximus.
  5172.  
  5173.           The operation of MECCA itself is fairly simple.  The command-line
  5174.           format is:
  5175.  
  5176.                MECCA <infile> [outfile] [-t]
  5177.  
  5178.           <infile> is the name of the input file, and if no extension is
  5179.           specified, an extension of '.MEC' will be used by default. 
  5180.           <infile> can include wildcards, so entering 'MECCA *.MEC' is
  5181.           perfectly valid.
  5182.  
  5183.           [outfile] is the name of the compiled output file.  This
  5184.           parameter is optional, and if not specified, it defaults to
  5185.           <infile>, using an extension of '.BBS'.
  5186.  
  5187.           In other words, typing 'MECCA BULLETIN' would cause MECCA to try
  5188.           to compile the file 'BULLETIN.MEC' into a file called
  5189.           'BULLETIN.BBS'.
  5190.  
  5191.           [-t] tells Maximus to compare the date stamps of the input and
  5192.           output files, and to skip the current file if the output filename
  5193.           is newer than the input filename.  This is useful for recompiling
  5194.           an entire directory of .MEC files, if you cannot remember what
  5195.           has changed.  Simply type 'MECCA *.MEC -t', and MECCA will
  5196.           automatically scan all of the files in the current directory, and
  5197.           recompile those which have changed.
  5198.  
  5199.           Documentation on the internal format of a *.MEC file itself, and
  5200.           the keywords used therein, is contained in the MECCA Command
  5201.           Language Reference, in the Maximus Technical Reference Manual.
  5202.  
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.  
  5209.  
  5210.  
  5211.  
  5212.  
  5213.  
  5214.  
  5215.  
  5216.  
  5217.  
  5218.                    Maximus 2.02 System Operations Manual - Page 92
  5219.  
  5220.  
  5221.  
  5222.  
  5223.           MR:  Maximus Renumbering Program
  5224.  
  5225.           MR is the Maximus-specific renumbering program.  MR is only used
  5226.           for *.MSG-style areas, since Squish areas renumber themselves on-
  5227.           the-fly.  MR automatically reads the information given in
  5228.           AREA.DAT, renumbers, deletes and relinks messages in *.MSG-style
  5229.           areas.
  5230.  
  5231.           The command line format for MR is:
  5232.  
  5233.                MR <area_dat> [area...]
  5234.  
  5235.           [area_dat] specifies the name of your Maximus AREA.DAT file. 
  5236.           This parameter must be given for MR to operate properly.
  5237.  
  5238.           [area...] specifies one or more message areas to be renumbered. 
  5239.           If no message areas are specified, MR will process all *.MSG
  5240.           areas on your system.
  5241.  
  5242.           When renumbering, MR will check the "Renum Days" and "Renum Max"
  5243.           settings for each message area.  (For more information on Renum
  5244.           Days and Renum Max, please see the MSGAREA.CTL section of the
  5245.           Maximus Technical Reference Manual.)  If either of those two
  5246.           keywords are set, MR will also purge messages based on the
  5247.           specified criteria.  Messages can be killed by message number, by
  5248.           age, or both.
  5249.  
  5250.           MR automatically updates the Maximus lastread files and message
  5251.           area links.  Essentially, just include a call to MR in your daily
  5252.           batch file, and all of your renumbering needs will be taken care
  5253.           off.  If you want to delete messages, make sure to include a
  5254.           "Renum Max" or "Renum Days" statement in MSGAREA.CTL for the
  5255.           areas to be trimmed.
  5256.  
  5257.  
  5258.  
  5259.  
  5260.  
  5261.  
  5262.  
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.  
  5269.  
  5270.  
  5271.  
  5272.  
  5273.                    Maximus 2.02 System Operations Manual - Page 93
  5274.  
  5275.  
  5276.  
  5277.  
  5278.           ORACLE:  Display File Viewer
  5279.  
  5280.           ORACLE is an off-line .BBS file viewer.  Unlike other BBS
  5281.           programs with embedded command languages, Maximus allows you to
  5282.           view compiled .BBS files without logging on, while still having
  5283.           the screens displayed exactly as they would be through Maximus
  5284.           itself.
  5285.  
  5286.           The command line format for ORACLE is:
  5287.  
  5288.                ORACLE <bbsfile> [[-x]...]
  5289.  
  5290.           <bbsfile> is the name of the compiled .BBS file you wish to view. 
  5291.           If no extension is supplied, then .BBS will be used by default.
  5292.  
  5293.           [-x] can be any of the following command-line parameters:
  5294.  
  5295.           -hX     Sets the current help level to 'X', where 'X' is the
  5296.                   first letter of a valid help level.  Valid options are
  5297.                   'hN' (Normal), '-hR' (Regular), '-hE' (Expert), and '-hH'
  5298.                   (Hotflash).
  5299.  
  5300.           -i      Disables high-bit IBM characters.  With this option
  5301.                   enabled, ORACLE will automatically translate IBM Extended
  5302.                   ASCII to the ASCII equivalent.
  5303.  
  5304.           -kX     Sets the user's keys to X, where X is simply a listing of
  5305.                   keys to assign to the user.  Valid keys are from 1-8 and
  5306.                   A-X.  For example, using '-k1237AD' would give keys 1, 2,
  5307.                   3, 7, A and D to the user.
  5308.  
  5309.           -mX     Sets the local video mode to X, where X is one of 'D'
  5310.                   (DOS), 'F' (FAST), 'B' (BIOS) or 'I' (IBM).  By default,
  5311.                   ORACLE will use the video mode defined in the control
  5312.                   file.  However, if you wish to use ORACLE from remote, it
  5313.                   may be necessary to use the DOS video mode, since output
  5314.                   from the IBM and FAST video modes normally cannot be
  5315.                   redirected to a COM port.
  5316.  
  5317.           -pX     This tells ORACLE to read the Maximus .PRM information
  5318.                   from the file 'X'.  If no PRM file is specified, then
  5319.                   ORACLE will default to using MAX.PRM, in the current
  5320.                   directory.  THIS PARAMETER IS REQUIRED!
  5321.  
  5322.           -q      This option enables the 'quick' hotkey mode.
  5323.  
  5324.           -slX    This option sets the virtual screen length to 'X' rows. 
  5325.                   This does not change your physical screen length;
  5326.  
  5327.  
  5328.                    Maximus 2.02 System Operations Manual - Page 94
  5329.  
  5330.  
  5331.  
  5332.                   however, it does determine when the 'More [Y,n,=]?'
  5333.                   prompts are displayed.  This option defaults to 24 lines.
  5334.           -swX    This option sets the virtual screen width to X columns. 
  5335.                   This does not change your physical screen width; however,
  5336.                   it does change the screen width, and controls when
  5337.                   virtual screen wraps will occur.
  5338.  
  5339.           -t      The -t parameter forces Oracle into TTY video mode.  This
  5340.                   will disable all ANSI and AVATAR graphics commands, and
  5341.                   display the file just as it would be shown to a TTY
  5342.                   caller.
  5343.  
  5344.           -vX     This sets the user's privilege level to 'X', where 'X' is
  5345.                   the first letter of a valid priv level.  For example,
  5346.                   '-va' would set the user's priv level to AsstSysOp, while
  5347.                   '-vl' would set the user's priv level to Limited.
  5348.  
  5349.           In addition to specifying the above parameters on the command
  5350.           line, you can also permanently set these options through an
  5351.           environment variable.  Instead of typing all of the parameters on
  5352.           the command line, you can simply place the same options into the
  5353.           ORACLE environment variable.
  5354.  
  5355.           For example, issuing the following sequence of commands:
  5356.  
  5357.                SET ORACLE=-pD:\Max\Max2.Prm -vS -q
  5358.                ORACLE D:\Max\Misc\Bulletin 
  5359.  
  5360.           is identical to entering all of this at once:
  5361.  
  5362.                ORACLE D:\Max\Misc\Bulletin -pD:\Max\Max2.Prm -vS -q
  5363.  
  5364.           Although the first example looks like more typing, you can easily
  5365.           place the SET command into your AUTOEXEC.BAT, and only type
  5366.           'ORACLE <filename>' for each future file you wish to display.
  5367.  
  5368.  
  5369.  
  5370.  
  5371.  
  5372.  
  5373.  
  5374.  
  5375.  
  5376.  
  5377.  
  5378.  
  5379.  
  5380.  
  5381.  
  5382.  
  5383.                    Maximus 2.02 System Operations Manual - Page 95
  5384.  
  5385.  
  5386.  
  5387.  
  5388.           PMSNOOP:  OS/2 Presentation Manager Monitoring Utility
  5389.  
  5390.           PMSNOOP is an OS/2 Presentation Manager utility that can be used
  5391.           to monitor the activity on an active Maximus or BinkleyTerm
  5392.           session.
  5393.  
  5394.           When Maximus is started, it automatically attempts to create a
  5395.           pipe called "\pipe\maxsnoop".  If the PMSnoop utility is
  5396.           activated, this pipe will be used for displaying Maximus log
  5397.           information on the desktop in a graphical format.
  5398.  
  5399.           PMSnoop is self-explanatory.  Simply run the program, use the
  5400.           menus to configure the snoop pipe name, and run a copy of Maximus
  5401.           to test out your configuration.  The main PMSnoop display area
  5402.           can be browsed using the horizontal and vertical scroll bars.
  5403.  
  5404.           Note that if you are running multiple copies of Maximus, each
  5405.           copy should use a different pipe name (specified using the '-z'
  5406.           command-line parameter).  Note that all pipes must start with the
  5407.           "\pipe\" prefix.
  5408.  
  5409.           If you wish to monitor more than one copy of Maximus, multiple
  5410.           copies of PMSnoop should be started, specifying the same pipe
  5411.           names as you did when starting Maximus.
  5412.  
  5413.  
  5414.  
  5415.  
  5416.  
  5417.  
  5418.  
  5419.  
  5420.  
  5421.  
  5422.  
  5423.  
  5424.  
  5425.  
  5426.  
  5427.  
  5428.  
  5429.  
  5430.  
  5431.  
  5432.  
  5433.  
  5434.  
  5435.  
  5436.  
  5437.  
  5438.                    Maximus 2.02 System Operations Manual - Page 96
  5439.  
  5440.  
  5441.  
  5442.  
  5443.           SCANBLD:  *.MSG Database Builder
  5444.  
  5445.           SCANBLD is the Maximus *.MSG database update utility.  SCANBLD is
  5446.           only required if you are using *.MSG areas; if you are using
  5447.           Squish-format areas (which have their own indexing), SCANBLD is
  5448.           not required and this section may be skipped.
  5449.  
  5450.           SCANBLD's primary function is to speed up Max's internal
  5451.           mailchecker, plus a few of the other internal commands.  Since
  5452.           the *.MSG storage system is very slow, an index file must be
  5453.           built for each area to provide reasonably fast mailchecking. 
  5454.           SCANBLD is not REQUIRED for using the mailchecker, but running
  5455.           the checker on a non-SCANBLD-compiled *.MSG area will be
  5456.           extremely slow.
  5457.  
  5458.           When SCANBLD runs, it creates a database of all of the messages
  5459.           in each area of your system.  SCANBLD must be run after certain
  5460.           actions, including after running a message renumbering utility,
  5461.           after receiving EchoMail, and so on.  This is somewhat
  5462.           inconvenient; however, unless you switch to the Squish message
  5463.           format, you'll have to use SCANBLD to maintain speed in your
  5464.           *.MSG areas.
  5465.  
  5466.           The command line format for SCANBLD is as follows:
  5467.  
  5468.                SCANBLD <user_bbs> <area_dat> ...
  5469.                     [ [All | Local | Matrix | Echo | Conf | @<afile> | ...
  5470.                     <areaname> | !<areaname> | /x]...]
  5471.  
  5472.           <user_bbs> specifies the name and location of your USER.BBS file. 
  5473.           This parameter is required.
  5474.  
  5475.           <area_dat> gives the name and location of your AREA.DAT file. 
  5476.           This parameter is required.
  5477.  
  5478.           After the two mandatory parameters, any of the following commands
  5479.           can appear in any order:
  5480.  
  5481.           ALL            Specifies that SCANBLD is to scan ALL areas,
  5482.                          regardless of what type of message area it is. 
  5483.                          This is the default, and all areas will be scanned
  5484.                          if no parameters are specified.  Note that SCANBLD
  5485.                          will only scan *.MSG areas.  Even if a Squish-
  5486.                          format message area is specified for processing,
  5487.                          that area will be automatically skipped.
  5488.  
  5489.           LOCAL          Specifies that SCANBLD should scan LOCAL areas.
  5490.  
  5491.  
  5492.  
  5493.                    Maximus 2.02 System Operations Manual - Page 97
  5494.  
  5495.  
  5496.  
  5497.           MATRIX         Specifies that SCANBLD should scan MATRIX areas.
  5498.  
  5499.           ECHO           Specifies that SCANBLD should scan ECHOMAIL areas.
  5500.  
  5501.           CONF           Specifies that SCANBLD should scan CONFERENCE
  5502.                          areas.
  5503.  
  5504.           @<afile>       Specifies that SCANBLD should read the named file
  5505.                          which contains a list of area tags.  SCANBLD will
  5506.                          compare those tags to those specified for the
  5507.                          'MsgName' keyword in each area, and process areas
  5508.                          with matching tags.  <afile> can be Max's own
  5509.                          ECHOTOSS.LOG, or it can be the import data files
  5510.                          produced by Squish, ConfMail or QM.
  5511.  
  5512.           <areaname>     Specifies a specific area number/name for SCANBLD
  5513.                          to process.
  5514.  
  5515.           !<areaname>    Specifies that this area is to be excluded from a
  5516.                          normal scan, and is not to be processed.  This is
  5517.                          useful if you have two separate area numbers
  5518.                          pointing to the same physical message path, or if
  5519.                          you want to exclude certain areas from one of the
  5520.                          above EchoMail/Matrix/Local scans.
  5521.  
  5522.           /c             Forces SCANBLD to do a full compile of each area
  5523.                          processed.  By default, SCANBLD will normally try
  5524.                          to update the mail database in the areas processed
  5525.                          without rebuilding the entire area.  You should
  5526.                          ALWAYS use this option after renumbering messages,
  5527.                          or else the message database will become out of
  5528.                          sync with the actual messages.
  5529.  
  5530.           /nd            Informs SCANBLD that you do NOT want the @<afile>
  5531.                          specification to be deleted after processing. 
  5532.                          This is useful if you have other utilities which
  5533.                          need the specified file, even after SCANBLD has
  5534.                          finished with it.
  5535.  
  5536.           /q             This switch forces SCANBLD into quiet mode. 
  5537.                          Instead of displaying each area's statistics,
  5538.                          SCANBLD will instead display a single hash sign
  5539.                          ('#') for each area processed.
  5540.  
  5541.           The options specified on SCANBLD's command-line are cumulative,
  5542.           so entering the following:
  5543.  
  5544.                SCANBLD user.bbs areas.dat echo matrix 45 !22 @et.log
  5545.  
  5546.  
  5547.  
  5548.                    Maximus 2.02 System Operations Manual - Page 98
  5549.  
  5550.  
  5551.  
  5552.           would cause SCANBLD to process all EchoMail areas, in
  5553.           addition to all NetMail areas, plus area number 45, plus the
  5554.           areas listed in the ECHOTOSS.LOG-format ET.LOG, with the
  5555.           exception of area number 22.
  5556.  
  5557.           It is suggested that you run SCANBLD as follows, since this
  5558.           procedure ensures that the mail databases always remain
  5559.           synchronized with the actual messages.
  5560.  
  5561.           AFTER A USER ENTERS ECHOMAIL (usually errorlevel 12):
  5562.  
  5563.                SCANBLD user.bbs area.dat local matrix @echotoss.log
  5564.  
  5565.           AFTER A USER ENTERS MATRIX MAIL (usually errorlevel 11):
  5566.  
  5567.                SCANBLD user.bbs area.dat local matrix
  5568.  
  5569.           AFTER A USER ENTERS LOCAL MAIL (usually errorlevel 5):
  5570.  
  5571.                SCANBLD user.bbs area.dat local
  5572.  
  5573.           AFTER IMPORTING ECHOMAIL:
  5574.  
  5575.                SCANBLD user.bbs area.dat local matrix @echotoss.log
  5576.  
  5577.           AFTER RUNNING ANY MESSAGE-RENUMBERING UTILITY:
  5578.  
  5579.                SCANBLD user.bbs area.dat all /c
  5580.  
  5581.           Finally, after using an external message editor, you must SCANBLD
  5582.           all of the areas which you entered messages in.  If your editor
  5583.           can produce an ECHOTOSS.LOG-like file, then you should run
  5584.           SCANBLD after your editor, using the command shown for 'If a user
  5585.           enters EchoMail'.  On the other hand, if your external editor
  5586.           does not produce an ECHOTOSS.LOG (or similar) file, then you must
  5587.           scan all areas, using the following command:
  5588.  
  5589.                SCANBLD user.bbs area.dat ALL
  5590.  
  5591.           IF THESE INSTRUCTIONS ARE NOT FOLLOWED TO THE LETTER, SCANBLD may
  5592.           miss messages which would otherwise be flagged as new mail.
  5593.  
  5594.  
  5595.  
  5596.  
  5597.  
  5598.  
  5599.  
  5600.  
  5601.  
  5602.  
  5603.                    Maximus 2.02 System Operations Manual - Page 99
  5604.  
  5605.  
  5606.  
  5607.  
  5608.           SILT:  Control File Compiler
  5609.  
  5610.           SILT is the Maximus control file compiler.  SILT takes the raw
  5611.           ASCII control files which you have created and turns them into
  5612.           something that Maximus can use directly.  Optionally, SILT can be
  5613.           instructed to parse only part of your system control files.
  5614.  
  5615.           Starting SILT is fairly easy; the command syntax of SILT is:
  5616.  
  5617.                SILT <ctl_file> [-a] [-m] [-o] [-p] [-s103] [-s110] ...
  5618.                     [-u] [-x]
  5619.  
  5620.           <ctl_file> specifies the name of the control file you want SILT
  5621.           to process, and is the only required argument.  If only the name
  5622.           of the control file is given with no other arguments, then SILT
  5623.           will process everything EXCEPT the SYSTEM*.BBS files.  Otherwise,
  5624.           SILT will only process the parts of the control file which are
  5625.           given on the command- line.  When specifying the control file, do
  5626.           not include the .PRM extension.
  5627.  
  5628.           -a        Tells SILT to compile only MSG/FILEAREA.CTL.
  5629.  
  5630.           -m        Tells SILT to generate the *.MNU files from MENUS.CTL.
  5631.  
  5632.           -p        Instructs SILT to generate MAX.PRM, and if requested,
  5633.                     the Opus version 14 and 17 *.PRM files.
  5634.  
  5635.           -s103     Tells SILT to create SYSTEM*.BBS files for Opus 1.03
  5636.                     compatibility, in addition to compiling only
  5637.                     MSG/FILEAREA.CTL.
  5638.  
  5639.           -s110     Tells SILT to create SYSTEM*.DAT files for Opus 1.10
  5640.                     compatibility, in addition to compiling only
  5641.                     MSG/FILEAREA.CTL.
  5642.  
  5643.           -u        Tells SILT to run in "unattended mode".  Normally, SILT
  5644.                     will prompt the user for input in certain situations,
  5645.                     including when a specified directory does not exist. 
  5646.                     (In such a case, SILT would ask the user whether or not
  5647.                     s/he want to create the directory.)  Using '-U' will
  5648.                     tell SILT not to stop to ask for directions, and to
  5649.                     create any nonexistent directories.
  5650.  
  5651.           -x        Causes SILT to compile everything, INCLUDING the
  5652.                     SYSTEM*.BBS and SYSTEM*.DAT files.
  5653.  
  5654.           -y        This switch tells SILT _not_ to sort message and file
  5655.                     area numbers into alphanumeric order.  By default, SILT
  5656.  
  5657.  
  5658.                    Maximus 2.02 System Operations Manual - Page 100
  5659.  
  5660.  
  5661.  
  5662.                     will sort message and file area numbers before writing
  5663.                     the final index.  If you wish to override the default
  5664.                     sort order, using the -y switch tells SILT to use areas
  5665.                     in the order that they are processed (with no sorting). 
  5666.                     This option can be used to override the default sorting
  5667.                     order.
  5668.  
  5669.  
  5670.  
  5671.  
  5672.  
  5673.  
  5674.  
  5675.  
  5676.  
  5677.  
  5678.  
  5679.  
  5680.  
  5681.  
  5682.  
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.  
  5689.  
  5690.  
  5691.  
  5692.  
  5693.  
  5694.  
  5695.  
  5696.  
  5697.  
  5698.  
  5699.  
  5700.  
  5701.  
  5702.  
  5703.  
  5704.  
  5705.  
  5706.  
  5707.  
  5708.  
  5709.  
  5710.  
  5711.  
  5712.  
  5713.                    Maximus 2.02 System Operations Manual - Page 101
  5714.  
  5715.  
  5716.  
  5717.                               RUNNING EXTERNAL PROGRAMS
  5718.  
  5719.           Although Maximus itself offers a large selection of internal
  5720.           features, chances are that you'll want to execute programs
  5721.           OUTSIDE of Maximus while a user is on-line.  Maximus can run
  5722.           almost all types of external programs, from customized file-
  5723.           transfer protocols, to 'door' programs written for another BBS
  5724.           program.
  5725.  
  5726.           Maximus can execute as many external programs as you wish, from
  5727.           either a menu option, or from a MECCA embedded command file. 
  5728.           Since these two pieces comprise the whole of the Maximus
  5729.           software, it means that you can run any external program
  5730.           anywhere, at any time.
  5731.  
  5732.  
  5733.           Execution Methods
  5734.  
  5735.           In general, Maximus supports four different methods of running
  5736.           external programs.  You can determine what type of exit you need
  5737.           by looking at the list below, and comparing the methods'
  5738.           advantages and disadvantages to the requirements of the program
  5739.           you wish to run.
  5740.  
  5741.           DOS:      This is the so-called 'normal' exit type.  Maximus will
  5742.                     load a second copy of COMMAND.COM (or CMD.EXE), and
  5743.                     then run the external program.
  5744.  
  5745.                     *    This is the only way to run a batch file as an
  5746.                          external program.
  5747.  
  5748.                     *    DOS only:
  5749.  
  5750.                          Since COMMAND.COM has to be loaded, your external
  5751.                          program will have about 174K less space to work
  5752.                          in.  (164K/Maximus + 10K/COMMAND.COM = 174K)
  5753.  
  5754.                     *    If the program is located on the PATH, no explicit
  5755.                          path needs to be given.
  5756.  
  5757.                     You can execute internal operating system commands
  5758.                     using this method, such as DIR, TYPE, CHDIR, etc.
  5759.  
  5760.           RUN:      This exit is identical to 'DOS', except that the
  5761.                     command interpreter is NOT loaded.  This means:
  5762.  
  5763.                     *    Your program will have a bit more memory to run
  5764.                          in, since a second COMMAND.COM or CMD.EXE is not
  5765.                          in memory.
  5766.  
  5767.  
  5768.                    Maximus 2.02 System Operations Manual - Page 102
  5769.  
  5770.  
  5771.  
  5772.                     *    You cannot run a batch file with this command.
  5773.  
  5774.                     *    This method will run faster than the DOS method
  5775.                          because COMMAND.COM does not have to be loaded.
  5776.  
  5777.           ERRORLVL: This command tells Maximus to exit completely from
  5778.                     memory, and exit to the calling batch file or program.
  5779.  
  5780.                     *    This command is slow, since the transient portion
  5781.                          of COMMAND.COM must be reloaded.
  5782.  
  5783.                     *    The only interface Maximus has with the external
  5784.                          program is an errorlevel.  (However, this is not
  5785.                          totally true.  See below about Errorlevel Batch
  5786.                          Files.)  Also, see below about restarting Maximus
  5787.                          after an errorlevel exit.
  5788.  
  5789.                     Note that the errorlevel method is not supported under
  5790.                     OS/2.
  5791.  
  5792.           ErrorLevel Batch Files
  5793.  
  5794.           When exiting via an errorlevel exit, Maximus uses a concept
  5795.           similar to BinkleyTerm's 'BBSBATCH' command, which allows Maximus
  5796.           to pass command-line parameters to an external program.  To
  5797.           create an errorlevel batch file, instead of specifying only an
  5798.           errorlevel as the command to execute, add a single SPACE
  5799.           character (or an underscore, if you are running the external
  5800.           program through a menu option), and then the name of the command
  5801.           you wish to run.
  5802.  
  5803.           ie. 'Xtern_Erlvl 65' -> 'Xtern_Erlvl 65_Myprg_Arg1_Arg2'.
  5804.  
  5805.           When Maximus encounters an argument after the errorlevel, it will
  5806.           write a file called ERRORLVL.BAT in the Maximus startup
  5807.           directory, containing the argument specified after the
  5808.           errorlevel.  (If you have a task number defined in MAX.CTL, then
  5809.           Max will write a file called 'ERRORLxx.BAT' instead, where 'xx'
  5810.           is the task number, in hexadecimal.  However, aside from the
  5811.           filename change, the use of ERRORLVL.BAT is identical to that in
  5812.           a single-node environment.)  In the case of the above example
  5813.           with MYPRG.EXE, the ERRORLVL.BAT file would contain:
  5814.  
  5815.                Myprg Arg1 Arg2
  5816.  
  5817.           Once the errorlevel batch file has been written, then Maximus
  5818.           will exit with the specified errorlevel.  You can then trap this
  5819.           errorlevel in your batch file, and use a 'CALL ERRORLVL.BAT'
  5820.           command to execute the command.  (If using DOS 3.2 or under,
  5821.  
  5822.  
  5823.                    Maximus 2.02 System Operations Manual - Page 103
  5824.  
  5825.  
  5826.  
  5827.           replace the 'CALL' with 'COMMAND /C'.)  After executing the
  5828.           external program, you can then restart Maximus by the method
  5829.           described in the next section.
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.  
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.  
  5869.  
  5870.  
  5871.  
  5872.  
  5873.  
  5874.  
  5875.  
  5876.  
  5877.  
  5878.                    Maximus 2.02 System Operations Manual - Page 104
  5879.  
  5880.  
  5881.  
  5882.  
  5883.           Restarting After Chain/Errorlevel
  5884.  
  5885.           After executing an external program via the CHAIN or ERRORLEVEL
  5886.           exit methods, Maximus can restart itself exactly where it left
  5887.           off and appear as if Maximus had remained in memory for the
  5888.           entire time.
  5889.  
  5890.           This feature is made possible through the '-r' command-line
  5891.           parameter.  When Maximus is invoked using '-r', it will read a
  5892.           file called RESTAR*.BBS from the root directory.  This file was
  5893.           written to disk just before Maximus executed the chain/errorlevel
  5894.           command.  This file contains all of the information that Maximus
  5895.           needs to start up again, so Maximus will simply pick up right
  5896.           where it left off, whether Maximus was displaying a menu or in
  5897.           the middle of a *.BBS file.
  5898.  
  5899.           Also make sure to specify the *.PRM file name on the
  5900.           command-line, if you are not using MAX.PRM.  In addition, if you
  5901.           are using a NON-ZERO task number, then you MUST accompany the
  5902.           '-r' option with the '-nXX' (set task number) option.
  5903.  
  5904.           WARNING!  Never attempt to use an '[xtern_erlvl]' token before a
  5905.           new caller has reached the NEWUSER2 file.  Maximus cannot perform
  5906.           a restart until it knows who the user is, and that means that the
  5907.           user must have entered their name, password, graphics selection,
  5908.           etc.
  5909.  
  5910.           This is an example batch file which utilizes errorlevel batch
  5911.           files, and also the restart option:
  5912.  
  5913.  
  5914.  
  5915.  
  5916.  
  5917.  
  5918.  
  5919.  
  5920.  
  5921.  
  5922.  
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.  
  5929.  
  5930.  
  5931.  
  5932.  
  5933.                    Maximus 2.02 System Operations Manual - Page 105
  5934.  
  5935.  
  5936.  
  5937.           REM * These first "%1 %2 %3" parameters will be passed to
  5938.           REM * the batch file by your mailer.  However, they
  5939.           REM * are not really important when dealing with errorlevel
  5940.           REM * batch files, so we'll just assume that they are
  5941.           REM * correct.  Also, make sure that the ':DoErlvl' label
  5942.           REM * comes AFTER the main 'Max -b%1 ...' command.
  5943.  
  5944.           Max -b%1 -p%2 -t%3 -n2
  5945.  
  5946.           :DoErlvl
  5947.           if errorlevel 65 goto Outside
  5948.           REM * [..more errorlevels here..]
  5949.           if errorlevel  1 goto end
  5950.           goto end
  5951.  
  5952.           :Outside
  5953.           REM * Replace the 'Call' with a 'Command /C', if using DOS
  5954.           REM * 3.2 or below!  Also, make sure that the number after
  5955.           REM * the '-n' parameter specifies the Maximus task number
  5956.           REM * to use, if not the one specified in the control
  5957.           REM * file.
  5958.           REM *
  5959.           REM * Finally, if you are using a non-zero task number, keep
  5960.           REM * in mind that the filename Maximus writes will be
  5961.           REM * 'ERRORLxx.BAT', where 'xx' is the hexadecimal task
  5962.           REM * number.
  5963.  
  5964.           call C:\Max\Errorlvl.Bat
  5965.           Max -r -n2
  5966.           goto DoErlvl
  5967.  
  5968.           :End
  5969.  
  5970.           After you have created a batch file such as this, using
  5971.           errorlevel exits becomes just as easy as any of the other exit
  5972.           types.  In MECCA, instead of using something in this format:
  5973.  
  5974.                [xtern_run]D:\Path\Progname.Exe Arg1 Arg2 
  5975.  
  5976.           one could easily replace it with something like this:
  5977.  
  5978.                [xtern_erlvl]65 D:\Path\Progname.Exe Arg1 Arg2
  5979.  
  5980.           As you can see, once you have added the errorlevel code to your
  5981.           batch files, adding new options requires only a minimal amount of
  5982.           work.
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.                    Maximus 2.02 System Operations Manual - Page 106
  5989.  
  5990.  
  5991.  
  5992.  
  5993.           External Program Translation Characters
  5994.  
  5995.           When passing a command-line to an external program (and also when
  5996.           parsing some special MECCA tokens), Maximus can include
  5997.           information about the user and SysOp by using special translation
  5998.           tokens.  A format token consists of a percent sign and a single,
  5999.           case-sensitive letter or symbol.  Maximus will interpret the
  6000.           character following the percent sign, and replace it with the
  6001.           variable which that character represents.
  6002.  
  6003.           Maximus currently supports the following external program
  6004.           translation characters:
  6005.  
  6006.           Char      Translation
  6007.  
  6008.           %!        Embeds a newline in a string.
  6009.           %A        The user's FIRST name, in upper-case.
  6010.           %b        The user's baud rate.  If the user is a local caller,
  6011.                     then this will translate to '0'.
  6012.           %B        The user's LAST name, in upper-case.  (If the user has
  6013.                     no last name, then this will translate into 'NLN', 'No
  6014.                     Last Name'.)
  6015.           %c        The user's city.
  6016.           %C        The response to the last '[menu]' MECCA token.
  6017.           %d        The area number of the current message area
  6018.           %D        The area number of the current file area
  6019.           %e        The user's password
  6020.           %E        The user's screen length, in rows
  6021.           %f        The user's first name, in mixed case.
  6022.           %F        Path to the current file area.
  6023.           %g        User's graphics mode -- '0' for TTY, '1' for ANSI, and
  6024.                     '2' for AVATAR.
  6025.           %G        User's Daily DL limit, in kilobytes
  6026.           %h        The user's phone number.
  6027.           %H        Number of kilobytes downloaded today
  6028.           %i        Total downloads
  6029.           %I        Total uploads
  6030.           %j        Minutes on-line, this call
  6031.           %k        The current node's task number.  ('0' for no task
  6032.                     number.)
  6033.           %K        The current node's task number in hexadecimal format
  6034.                     padded with leading zero to make it two characters.
  6035.                     ('0' for no task number.)
  6036.           %l        The user's last name, in mixed case.  If the user has
  6037.                     no last name, then this will translate into 'NLN'.
  6038.           %L        If the user is REMOTE, this will translate into the
  6039.                     string '-pX -bY', where X is the port number (1=COM1,
  6040.  
  6041.  
  6042.  
  6043.                    Maximus 2.02 System Operations Manual - Page 107
  6044.  
  6045.  
  6046.  
  6047.                     2=COM2, etc) and 'y' is the baud rate.  If the user is
  6048.                     LOCAL, this will translate into a simple '-k'.
  6049.           %m        The name of the first file to transfer when invoking an
  6050.                     external protocol.
  6051.           %M        Path to the current message area.
  6052.           %n        User's full name, in mixed case.
  6053.           %N        The name of your BBS, as defined in MAX.CTL.
  6054.           %p        The current port number (0=COM1, 1=COM2, etc).
  6055.           %P        The current port number (1=COM1, 2=COM2, etc).
  6056.           %q        Path to the current msg area (NO trailing backslash)
  6057.           %Q        Path to the current file area (NO trailing backslash)
  6058.           %r        The user's real name, if applicable.
  6059.           %R        All remaining stacked text, as entered at the last
  6060.                     menu.
  6061.           %s        The SysOp's last name, in mixed case.  If the SysOp has
  6062.                     no last name, then this will translate into 'NLN'.
  6063.           %S        The SysOp's first name, in mixed case.
  6064.           %t        The amount of time the user has left, in minutes.
  6065.           %T        The amount of time the user has left, in seconds.
  6066.           %u        The user's user number.
  6067.           %U        Simply translates to an underscore.
  6068.           %v        Path to the current upload area (with trailing
  6069.                     backslash)
  6070.           %V        Path to the current upload area (NO trailing backslash)
  6071.           %w        The path to the current FILES.BBS-type file.  This
  6072.                     takes into account the alternate names which may be
  6073.                     used by the 'FileList' option.
  6074.           %W        The "steady baud rate", as passed via the -s
  6075.                     command-line parameter.
  6076.           %x        Drive letter of current drive, in upper case.
  6077.           %X        The last read message number for the current message
  6078.                     area.  This only works while in a message area. 
  6079.           %Y        The user's current language number, zero based (0 is
  6080.                     first language, 1 is second, etc.)
  6081.           %Z        Translates to the user's full name, in caps.
  6082.  
  6083.           In addition to the above translation characters, there is also
  6084.           another set of almost-identical characters, which can be used
  6085.           when giving Maximus the name of a file to display.  However, the
  6086.           first character in sequence should be a "+", rather than the
  6087.           usual "%".  The second character WILL be treated as shown above,
  6088.           and translated normally.  For example, to display a file called
  6089.           D:\<#>.BBS, where <#> is the user's number, you would use the
  6090.           following command in MENUS.CTL:
  6091.  
  6092.                Display_File  D:\+u.BBS  Twit  "Display It!"
  6093.  
  6094.  
  6095.  
  6096.  
  6097.  
  6098.                    Maximus 2.02 System Operations Manual - Page 108
  6099.  
  6100.  
  6101.  
  6102.           Please keep in mind that the usage of the "+" is only required
  6103.           when specifying a filename to display.  The percent sign should
  6104.           be used in all other cases.
  6105.  
  6106.           Finally, there is one additional shortcut for *.MNU menu names. 
  6107.           If you wish to substitute the current task number in a filename,
  6108.           then substitute the "*" character where you wish the task number
  6109.           to appear, and Maximus will translate it automatically.  For
  6110.           example, the following line...
  6111.  
  6112.                First Menu  MAIN*
  6113.  
  6114.           would cause task 0 to display a menu called MAIN00.MNU when first
  6115.           executed, task 1 to display MAIN01.MNU, etc.  (Keep in mind that
  6116.           the task number is in hexadecimal, and therefore the menu
  6117.           displayed for task 12 would be MAIN0C.MNU.)
  6118.  
  6119.  
  6120.  
  6121.  
  6122.  
  6123.  
  6124.  
  6125.  
  6126.  
  6127.  
  6128.  
  6129.  
  6130.  
  6131.  
  6132.  
  6133.  
  6134.  
  6135.  
  6136.  
  6137.  
  6138.  
  6139.  
  6140.  
  6141.  
  6142.  
  6143.  
  6144.  
  6145.  
  6146.  
  6147.  
  6148.  
  6149.  
  6150.  
  6151.  
  6152.  
  6153.                    Maximus 2.02 System Operations Manual - Page 109
  6154.  
  6155.  
  6156.  
  6157.  
  6158.           Running Doors
  6159.  
  6160.           A 'door' is just a fancy name for an external program which can
  6161.           be run and can communicate with an on-line user.  Most door
  6162.           programs contain modem routines, so they can keep track of a
  6163.           user's time limit, make sure that the user does not drop carrier
  6164.           while inside the door, etc.
  6165.  
  6166.           However, running a door program presents a special problem. 
  6167.           There are several conflicting standards for 'door interfaces',
  6168.           which are what controls the way the BBS program passes
  6169.           information to the door.  Most modern door interfaces can pass
  6170.           out the user's name, whether or not the user supports ANSI
  6171.           graphics, the name of the SysOp, etc.
  6172.  
  6173.           Maximus includes built-in support for the Opus 1.03 LASTUSER.BBS
  6174.           standard, as well as the capability to DIRECTLY write ANY
  6175.           text-based door interface file.  The distribution version of
  6176.           Maximus comes with MECCA scripts which allow you to create door
  6177.           interface files for the following formats: DORINFO1.DEF (QuickBBS
  6178.           and RBBS), CHAIN.TXT (WWIV), CALLINFO.BBS (WildCat!) and
  6179.           DOOR.SYS.  In addition, you can write your own MECCA scripts,
  6180.           which allow you to generate a door interface file for almost any
  6181.           other system type.
  6182.  
  6183.           Maximus can achieve this through the use of the '[write]' MECCA
  6184.           token.  Although the '[open]' and '[post]' commands were
  6185.           originally used for on-line questionnaires, they serve a dual
  6186.           purpose under Maximus.  The '[write]' token will simply write a
  6187.           line of text to the previously-opened file, while making
  6188.           translations to the string, as described in the 'External Program
  6189.           Translation Characters' section, above.
  6190.  
  6191.           For example, the only requirement to make Maximus write a
  6192.           QuickBBS or RBBS-compatible DORINFO1.DEF file is to copy the
  6193.           following MECCA script into a file called DORINFO.MEC, and
  6194.           compile it.  (Note!  If you are using the standard distribution
  6195.           package, then you can find this file, including the compiled .BBS
  6196.           version, in the \MAX\MISC subdirectory.)
  6197.  
  6198.           When copying this into a file, be sure to line up all of the text
  6199.           against the left margin.  Also make sure to change the [delete]
  6200.           and [open] tokens to reflect the path where you want the
  6201.           DORINFO1.DEF interface file to be placed.)
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.                    Maximus 2.02 System Operations Manual - Page 110
  6209.  
  6210.  
  6211.  
  6212.           [delete]C:\Max\Dorinfo1.Def
  6213.           [open]C:\Max\Dorinfo1.Def
  6214.           [write]%N               [ comment Write the BBS name]
  6215.           [write]%S               [ comment Write the SysOp's f.name]
  6216.           [write]%s               [ comment Write the SysOp's l.name]
  6217.           [islocal write]COM0     [ comment Write the COM port]
  6218.           [isremote write]COM%P   [ comment (local is always COM0)]
  6219.           [write]%b BAUD,N,8,1    [ comment Write the baud rate]
  6220.           [write] 0               [ comment Say we are not networked]
  6221.           [write]%A               [ comment Write the first name]
  6222.           [write]%B               [ comment Write the last name]
  6223.           [write]%c               [ comment Write the city]
  6224.           [write]%g               [ comment Write the graphics]
  6225.           [sequal write]100       [ comment Write the security level]
  6226.           [sxclude write]50       [ comment Ditto]
  6227.           [write]%t               [ comment Write the time remaining]
  6228.           [write]1                [ comment Say we are using a FOSSIL]
  6229.           [quit]                  [ comment And we are done!]
  6230.  
  6231.           You can create similar files for other door interface types, by
  6232.           simply creating another MECCA file containing the appropriate
  6233.           commands.  (A list of the external program translation characters
  6234.           has been provided in the prior section; however, you can use the
  6235.           above DORINFO.MEC file as a guide to designing your own door
  6236.           interface files.)
  6237.  
  6238.           There are three ways to have DORINFO1.DEF (or any of the
  6239.           above-mentioned files) created when running an external program:
  6240.  
  6241.           TO CREATE DORINFO1.DEF FROM A .MEC FILE:
  6242.  
  6243.                To have the appropriate door file created, simply include
  6244.                the following line, whenever you wish to have DORINFO1.DEF
  6245.                written:
  6246.  
  6247.                [link]C:\Max\Misc\Dorinfo
  6248.  
  6249.                As mentioned above, the distribution version of Maximus also
  6250.                comes with MECCA scripts to generate several other types of
  6251.                door interfaces.  The format for using these is similar to
  6252.                the interface described above:
  6253.  
  6254.                [link]C:\Max\Misc\WWIV        - To create CHAIN.TXT
  6255.                [link]C:\Max\Misc\CallInfo    - To create CALLINFO.BBS
  6256.                [link]C:\Max\Misc\DoorSys     - To create DOOR.SYS
  6257.  
  6258.           TO CREATE DORINFO1.DEF FROM A MENU OPTION:
  6259.  
  6260.  
  6261.  
  6262.  
  6263.                    Maximus 2.02 System Operations Manual - Page 111
  6264.  
  6265.  
  6266.  
  6267.                Similarly, you can achieve the same results through a menu
  6268.                option, by simply linking the appropriate .BBS file to the
  6269.                menu option.  (For more information, please see 'Linking
  6270.                Menu Options' in the Maximus Technical Reference Manual.)
  6271.  
  6272.                For example, to create a DORINFO1.DEF file for running a
  6273.                program called 'C:\Max\Prg.Exe', you would use something
  6274.                similar to the following in MENUS.CTL:
  6275.  
  6276.                  Display_File   C:\Max\Misc\Dorinfo Twit "Run Prg.Exe"
  6277.           NoDsp  Xtern_Run      C:\Max\Prg.Exe      Twit "R"
  6278.  
  6279.                Again, the same concept can also be applied to the other
  6280.                MECCA-created door scripts, by simply substituting the name
  6281.                of the script into the Display_File command.
  6282.  
  6283.           TO HAVE DORINFO1.DEF CREATED AUTOMATICALLY:
  6284.  
  6285.                If you wish to have DORINFO1.DEF written every time Maximus
  6286.                exits for an external program, for whatever reason, you can
  6287.                simply edit the 'Uses Leaving' statement in MAX.CTL, such
  6288.                that it reads like this:
  6289.  
  6290.                     Uses Leaving C:\Max\Misc\Dorinfo
  6291.  
  6292.                This will instruct Maximus to create DORINFO1.DEF whenever
  6293.                Maximus runs an external program, without needing to be
  6294.                specifically instructed to.
  6295.  
  6296.           What follows is a demonstration of how to install a non- Maximus
  6297.           door in a menu file, assuming that you have NOT implemented the
  6298.           above 'Uses Leaving' statement in MAX.CTL.
  6299.  
  6300.           In MENUS.CTL, you should add the following to the menu which you
  6301.           wish the door to appear on.
  6302.  
  6303.                   Display_File  Misc\DorInfo   Disgrace   "Play BoreDoor"
  6304.           NoDsp   Xtern_Dos     BD\Bore.Bat    Disgrace   "P"
  6305.  
  6306.           The 'Display_File' command tells Maximus to write the
  6307.           DORINFO1.DEF file, which will always be written to the C:\MAX
  6308.           directory (unless you have changed the .MEC file).
  6309.  
  6310.           The 'Xtern_Run' command tells Maximus to run the batch file
  6311.           called BD\BORE.BAT, which you'll need to create later.  (The
  6312.           'NoDsp' in front tells Maximus not to show 'P' on the menu a
  6313.           second time, since you only want the first 'Play BoreDoor' to be
  6314.           visible.  See the section on Linking Menu Options (in the Maximus
  6315.           Technical Reference Manual) for more details.)
  6316.  
  6317.  
  6318.                    Maximus 2.02 System Operations Manual - Page 112
  6319.  
  6320.  
  6321.  
  6322.           When a user selects 'P' from the menu, Maximus will execute the
  6323.           above options in order.  That means that DORINFO1.DEF will first
  6324.           be written, followed by the execution of BORE.BAT.
  6325.  
  6326.           Although the contents of the batch file are highly specific to
  6327.           the door program you'll be running, in general, you should use a
  6328.           format similar to this, in BORE.BAT:
  6329.  
  6330.                echo off
  6331.  
  6332.                REM * Change to the right directory
  6333.                cd \Max\BD
  6334.  
  6335.                REM * Copy the DORINFO1.DEF file from the
  6336.                REM * main Maximus directory into the
  6337.                REM * current directory, which is probably
  6338.                REM * where the door program will look for
  6339.                REM * it.
  6340.                copy \Max\Dorinfo1.Def
  6341.  
  6342.                REM * This is the door program itself.  The
  6343.                REM * command-line parameters will be
  6344.                REM * specific to the door you are running, so
  6345.                REM * you should consult your door's installation
  6346.                REM * instructions for more details.
  6347.                BoreDoor
  6348.  
  6349.                REM * Now change back to the Maximus
  6350.                REM * directory.
  6351.                cd \Max
  6352.  
  6353.                REM * And exit back to Max!
  6354.                exit
  6355.  
  6356.  
  6357.  
  6358.  
  6359.  
  6360.  
  6361.  
  6362.  
  6363.  
  6364.  
  6365.  
  6366.  
  6367.  
  6368.  
  6369.  
  6370.  
  6371.  
  6372.  
  6373.                    Maximus 2.02 System Operations Manual - Page 113
  6374.  
  6375.  
  6376.  
  6377.  
  6378.           On-Line User Record Modification
  6379.  
  6380.           Some door programs may be written specifically for Maximus, and
  6381.           may need to directly change part of a user's profile (such as the
  6382.           user's remaining time, ANSI/AVATAR preference, phone number,
  6383.           etc.), even while the user is on-line.  Maximus supports this
  6384.           feature through a series of special keywords and characters,
  6385.           which cause it to re-read the LASTUSxx.BBS file after returning
  6386.           from an external program.
  6387.  
  6388.           If you are running the external program through an option in
  6389.           MENUS.CTL, then the fastest way to enable on-line modification is
  6390.           to place the 'ReRead' modifier in front of the usual 'Xtern_xxx'
  6391.           option.  In other words, instead of invoking the program like
  6392.           this:
  6393.  
  6394.                     Xtern_Run   D:\Path\Prog.Exe   Disgrace  "Program"
  6395.  
  6396.           you would place the following line in MENUS.CTL, which would
  6397.           enable on-line modification:
  6398.  
  6399.           ReRead    Xtern_Run   D:\Path\Prog.Exe   Disgrace  "Program"
  6400.  
  6401.           Similarly, you can perform the same operation when using the
  6402.           [xtern_xxx] MECCA tokens, by using an '@' as the first character
  6403.           in the program name.  For example, instead of using this:
  6404.  
  6405.                [xtern_run]D:\Path\Prog.Exe
  6406.  
  6407.           you would use this, instead:
  6408.  
  6409.                [xtern_run]@D:\Path\Prog.Exe
  6410.  
  6411.           However, keep in mind that most programs do not need this
  6412.           feature.  For security reasons, you should not use this feature,
  6413.           unless the external program's documentation states that on-line
  6414.           modification will be performed.
  6415.  
  6416.  
  6417.  
  6418.  
  6419.  
  6420.  
  6421.  
  6422.  
  6423.  
  6424.  
  6425.  
  6426.  
  6427.  
  6428.                    Maximus 2.02 System Operations Manual - Page 114
  6429.  
  6430.  
  6431.  
  6432.  
  6433.           Doors under OS/2
  6434.  
  6435.           Normally, OS/2-based communications programs can only run other
  6436.           OS/2-based programs as doors.  This means that, for example,
  6437.           trying to run a DOS-based door under the OS/2 version of Maximus
  6438.           normally does not work.
  6439.  
  6440.           However, if you are using the third-party SIO.SYS communication
  6441.           driver (as described in the installation section), some DOS doors
  6442.           can be made to work with the OS/2 version of Maximus.  See the
  6443.           documentation for SIO for more information.
  6444.  
  6445.           Aside from this restrictions, running OS/2 doors is usually much
  6446.           easier than running DOS-based doors.  OS/2 programs have no 640k
  6447.           memory limit, so there is no need for swapping or the Xtern_Erlvl
  6448.           feature.
  6449.  
  6450.           One feature of OS/2 communications programs is that they all use
  6451.           "port handles" when passing control from one program to another. 
  6452.           A port handle is created (by the DosOpen system call) when an
  6453.           application opens a com port for I/O.
  6454.  
  6455.           To allow other applications to access the port, the program that
  6456.           "owns" the com port spawns the door program directly, giving it
  6457.           the port handle number for the open communications port.  The
  6458.           spawned program must use this handle to communicate with the
  6459.           port.  (When spawning Maximus from BinkleyTerm, the "-p" command-
  6460.           line parameter is used to pass this port handle number.)
  6461.  
  6462.           Due to OS/2's file-handle sharing architecture, any attempt to
  6463.           access the port without using the handle number will fail.  (This
  6464.           is the reason why DOS doors cannot be used under Maximus-OS/2. 
  6465.           DOS programs do not know about com port handles, so they normally
  6466.           cannot inherit the com port from an OS/2 communications program,
  6467.           unless using the special SIO device driver.)
  6468.  
  6469.  
  6470.  
  6471.  
  6472.  
  6473.  
  6474.  
  6475.  
  6476.  
  6477.  
  6478.  
  6479.  
  6480.  
  6481.  
  6482.  
  6483.                    Maximus 2.02 System Operations Manual - Page 115
  6484.  
  6485.  
  6486.  
  6487.                               MULTI-LINE OPERATION GUIDE
  6488.  
  6489.           In addition to general multi-line support, Maximus 2.02 supports
  6490.           an integrated paging and inter-node chat facility, which makes it
  6491.           ideal for multi-line systems.  In addition, Maximus uses
  6492.           NetBIOS-compatible file opening calls (using the SH_DENYNONE
  6493.           attribute), which makes Maximus even more suited for network
  6494.           applications.
  6495.  
  6496.           This section is merely a guide to running Maximus in a multi-line
  6497.           environment.  Undoubtedly, there will be some problems which are
  6498.           not covered by this section, and there will be some questions
  6499.           left unanswered.  However, this section will hopefully answer
  6500.           most of the basic questions, and at least give you a head start
  6501.           on installing a multi-node version of Maximus.
  6502.  
  6503.  
  6504.           Installation
  6505.  
  6506.           Installation of a network version of Maximus is fairly similar to
  6507.           a normal installation.  Simply run the INSTALL program, and
  6508.           answer all of the questions it asks.
  6509.  
  6510.           However, there are several important things to consider:
  6511.  
  6512.           *    Normally, you'll need a SEPARATE batch file for EACH copy of
  6513.                Maximus you wish to run.  You can reduce duplication by
  6514.                moving common parts of the batch file into a separate file
  6515.                and calling it with CALL or COMMAND/C, but you'll still need
  6516.                a separate batch file for each node you wish to run. 
  6517.                However, all Max tasks can be run out of the same directory,
  6518.                so you can run everything out of \MAX.
  6519.  
  6520.                Fortunately, you only need one copy of the MAX.PRM file: 
  6521.                you can use the '-nXX' and '-lX' command line parameters to
  6522.                adjust the task number and log filenames at runtime. 
  6523.                However, you DO need to specify a separate log file for each
  6524.                task.  Naming the log Line01.Log for task 1, Line02.Log for
  6525.                task 2, and so on is a reasonably way of handling log files. 
  6526.                (If you do not want a log file for a certain node, then
  6527.                simply use the '-l' command line parameter without
  6528.                specifying a filename.)
  6529.  
  6530.                OS/2 users should also use a different snoop pipe path using
  6531.                the '-z' command-line parameter.
  6532.  
  6533.                Even if you use the same .PRM file for all tasks, you can
  6534.                still display node-specific files to the user through the
  6535.                use of the '*' token.  When display a .BBS file, '*'
  6536.  
  6537.  
  6538.                    Maximus 2.02 System Operations Manual - Page 116
  6539.  
  6540.  
  6541.  
  6542.                translates into the current two-digit task number, zero-
  6543.                padded and in hexadecimal.  For example, if you specified
  6544.                'D:\Max\Misc\Welcom*' as the welcome file in MAX.CTL,
  6545.                Maximus would display WELCOM01.BBS for task 1, WELCOME02.BBS
  6546.                for task 2, and so on.
  6547.  
  6548.  
  6549.                Advanced users:  It is actually possible to run multiple
  6550.                copies of Max with only one batch file.  If you set an
  6551.                environment variable to equal the current node number, you
  6552.                can use that variable as a replaceable parameters in a
  6553.                single batch file.  However, this requires a bit of
  6554.                knowledge about DOS, so it is not recommended for normal
  6555.                users.
  6556.  
  6557.           *    When setting up your batch files, you should make sure that
  6558.                ALL copies of Maximus are started from the same directory. 
  6559.                This will allow you to share some files between nodes, in
  6560.                addition to providing a cleaner directory structure.
  6561.  
  6562.           *    If you are part of FidoNet, you may want to run a mailer on
  6563.                one line only.  Fortunately, the internal WFC module can be
  6564.                used on a node-by-node basis with the same set of control
  6565.                files.  For more information on using WFC, please see the
  6566.                section of the installation entitled "Support for Remote
  6567.                Callers".
  6568.  
  6569.           *    When looking for a compatible FOSSIL, it may take a bit of
  6570.                work to find one that runs correctly under your network
  6571.                software.  If you are having mysterious communications
  6572.                problems, then try switching to a different FOSSIL.  There
  6573.                are at least three different types for the IBM PC, so you
  6574.                should have no problem finding one which works with your
  6575.                hardware.
  6576.  
  6577.           *    In your AUTOEXEC.BAT, you may wish to include commands to
  6578.                delete ACTIVE*.BBS and UTASK*.* from the main Maximus
  6579.                directory, and IPC*.BBS from the inter-process
  6580.                communications directory.  These are temporary files created
  6581.                by Maximus during execution, so they should not be left
  6582.                lying around.  If you need to restart the network while
  6583.                Maximus is running, these files will not get deleted which
  6584.                may cause future problems.  To fix this, you should include
  6585.                the above-mentioned delete commands in your AUTOEXEC.BAT to
  6586.                make sure that you start with a clean slate whenever you
  6587.                reboot.  (In the case of a network, the delete commands
  6588.                should be placed in the server's AUTOEXEC.BAT.  If you are
  6589.                running DESQview or some other multitasker on a single node,
  6590.  
  6591.  
  6592.  
  6593.                    Maximus 2.02 System Operations Manual - Page 117
  6594.  
  6595.  
  6596.  
  6597.                then you can also place those statements in your main
  6598.                AUTOEXEC.BAT.)
  6599.  
  6600.           *    If you wish to use either of the multi-node chat or the
  6601.                paging features, your operating system must support file and
  6602.                record locking.  Under DOS, this means that you must load
  6603.                the DOS "SHARE" program.  Under OS/2, file locking is built
  6604.                into the operating system, so no special utilities are
  6605.                necessary.  Although it is possible to use Maximus in a
  6606.                multi-node environment without loading SHARE (through the
  6607.                'No Share.Exe' option in MAX.CTL), this is strongly
  6608.                discouraged, and no guarantees are made if you do not load
  6609.                SHARE.
  6610.  
  6611.           *    Make sure that all copies of Max have a unique and NON-ZERO
  6612.                task number.  If the task number is set to zero, Maximus
  6613.                will assume that you are running in a single-node
  6614.                environment, and will not bother to check the inter-process
  6615.                communications area.  In fact, none of the multi-node
  6616.                features will work if you are using a task number of zero.
  6617.  
  6618.  
  6619.           Multi-Node Chat Operation
  6620.  
  6621.           The main way in which Maximus takes advantage of multiple lines
  6622.           is through the integrated multi-node chat and paging facility. 
  6623.           These features are much like those found in the commercial
  6624.           PCBoard and TBBS programs and are just as flexible.  Users can
  6625.           toggle whether or not they can be paged by others, they can
  6626.           display a list of who is on-line, and they can actually enter
  6627.           into a real-time conversation with other callers.
  6628.  
  6629.           The first step in configuring the multi-node chat is to enable
  6630.           the 'Path IPC' statement in MAX.CTL.  (Make sure to follow the
  6631.           instructions in the 'Path IPC' description about installing
  6632.           SHARE.EXE and creating a RAM disk!)
  6633.  
  6634.           The second step is to edit MENUS.CTL and uncomment the
  6635.           Display_Menu option which calls the CHAT menu.  Although you can
  6636.           use a custom MenuFile for the chat section, it is best to leave
  6637.           this for later, and use the built-in 'MenuHeader Chat' for now. 
  6638.           You can worry about tweaking the cosmetics once everything is
  6639.           running smoothly.
  6640.  
  6641.           Having changed MENUS.CTL, the only remaining step is to recompile
  6642.           the control files.  But before allowing users to call the system,
  6643.           you should first test it yourself, by logging onto two nodes
  6644.           locally.  (You'll have to use two different user names, since
  6645.           Maximus will only let one user hog one node at a time.)
  6646.  
  6647.  
  6648.                    Maximus 2.02 System Operations Manual - Page 118
  6649.  
  6650.  
  6651.  
  6652.           Before testing the chat mode itself, enter the Chat Section, and
  6653.           look at the menu display.  The table should show the node number
  6654.           which you are logged on to (including your name, and the '(you)'
  6655.           designation), in addition to the same information about the
  6656.           second node.  (If there is no display, check to make sure that
  6657.           you have implemented the 'Path IPC' keyword, and that it points
  6658.           to a valid drive and directory.  Another possibility is that you
  6659.           have forgotten to load SHARE.EXE.)
  6660.  
  6661.           If the menu display seems to be in order, the next step it to try
  6662.           toggling your chat availability a few times.  After your status
  6663.           has been toggled, the table should indicate whether or not you
  6664.           are available for chat, in the 'Status' portion of the table. 
  6665.           You can also check that the other node was informed of the
  6666.           change, by simply entering the Chat Section on the second node,
  6667.           and looking at the table on that system.
  6668.  
  6669.           Finally, after you have confirmed that everything else is
  6670.           working, you can enter the multi-node chat itself.  To initiate a
  6671.           chat, select the P)age option.  Then enter the number of the
  6672.           other node you have logged onto, and wait for the chat request to
  6673.           register.  (This should take no longer than about 15 seconds.)
  6674.  
  6675.           After you have paged the user, you should see a 'You are being
  6676.           paged by Joe SysOp (node XX)' message on the other node.  This is
  6677.           the canned page message; to modify it, you can either edit the
  6678.           ENGLISH.MAD language file, or you can create a
  6679.           \MAX\MISC\CHATPAGE.MEC file.  (For information on the latter, see
  6680.           the section on hardcoded filenames.)
  6681.  
  6682.           To answer the chat request, simply select the A)nswer Page option
  6683.           and enter the node number of the user who sent the request.  This
  6684.           should place you inside chat mode:  the other user should see a
  6685.           'User Name joins the conversation' message, which indicates that
  6686.           the other user answered the chat request.
  6687.  
  6688.           The user who answered the page will not see anything immediately;
  6689.           to find out who is participating in the conversation, you can
  6690.           simply type a '/w' command at the beginning of a line, and
  6691.           Maximus will display the list of callers on the same channel.  To
  6692.           list all of the callers on the system, whether or not they re in
  6693.           chat, type '/s'.
  6694.  
  6695.           Once in chat, users can send messages to each other by simply
  6696.           typing the text that they wish to send.  Maximus will
  6697.           automatically word-wrap at the end of lines, and the text will be
  6698.           transmitted one line at a time.  If possible, it is best to try
  6699.           typing a few times from each node to make sure that the chat
  6700.           function is working properly.
  6701.  
  6702.  
  6703.                    Maximus 2.02 System Operations Manual - Page 119
  6704.  
  6705.  
  6706.  
  6707.           Once you are finished testing, you can use the '/q' command on
  6708.           each node to exit chat mode.  (When a node exits chat, the other
  6709.           nodes participating in the same chat should see a 'User Name
  6710.           leaves the conversation' message.)
  6711.  
  6712.           In addition to the private chat facility (which is what you just
  6713.           tested), Maximus also supports a group chat, or a 'virtual CB'
  6714.           chat.  The CB chat is useful when you have three or more nodes,
  6715.           and want to have more than two callers in one conference. 
  6716.           Maximus supports 255 concurrent 'channels', which means that
  6717.           there can be up to 255 separate group conversations going on at
  6718.           the same time.  However, the CB chat has no paging ability; it is
  6719.           up to the callers to look at the status screen in the Chat
  6720.           Section, and see which channel everyone else is using.
  6721.  
  6722.           Aside from the differences in invoking the CB chat, once you get
  6723.           inside the chat mode itself, Maximus will behave just as it does
  6724.           inside the private chat, even using the same commands.  For more
  6725.           information on using Max's multi-line chat, please see the chat
  6726.           help file, included in the Maximus distribution package. 
  6727.           (Assuming a standard system, the help file is accessible using
  6728.           the '?' command from the chat menu, or through the '/?' command
  6729.           inside chat mode.)
  6730.  
  6731.  
  6732.  
  6733.  
  6734.  
  6735.  
  6736.  
  6737.  
  6738.  
  6739.  
  6740.  
  6741.  
  6742.  
  6743.  
  6744.  
  6745.  
  6746.  
  6747.  
  6748.  
  6749.  
  6750.  
  6751.  
  6752.  
  6753.  
  6754.  
  6755.  
  6756.  
  6757.  
  6758.                    Maximus 2.02 System Operations Manual - Page 120
  6759.  
  6760.  
  6761.  
  6762.                                   USING CUSTOM MENUS
  6763.  
  6764.           Maximus allows you to create custom menus with relative ease:
  6765.           simply insert a 'MenuFile' command in the appropriate section of
  6766.           MENUS.CTL, and you are done.  However, there are several tips and
  6767.           tricks you may find useful when designing custom menus,
  6768.           especially when using fancy ANSI or AVATAR graphics.
  6769.  
  6770.           *    When using a menu which contains a '[cls]' MECCA token,
  6771.                you'll notice that output from some of the internal commands
  6772.                (such as Version or Statistics) disappears, since the [cls]
  6773.                command in the menu erases it, before it can be seen by the
  6774.                user.  The solution for this is to link a 'Press_Enter' menu
  6775.                option after the appropriate command, which will cause
  6776.                Maximus to wait until the user presses <enter>, before
  6777.                re-displaying the menu.  (For more details, see the section
  6778.                entitled 'Linking Menu Options' in the Maximus Technical
  6779.                Reference Manual.)  For example, to make Maximus wait after
  6780.                displaying the user's statistics, you might use something
  6781.                like this:
  6782.  
  6783.                     Statistics     Disgrace  "Statistics"
  6784.           NoDsp     Press_Enter    Disgrace  "S"
  6785.  
  6786.           *    If you are using a custom MenuFile statement in the message
  6787.                or file areas, you should never disable the MenuHeader
  6788.                statement.  If all you want to do is to suppress the
  6789.                'MESSAGE Section' banner and statistics information, use
  6790.                "SilentMenuHeader Message" or "SilentMenuHeader File"
  6791.                instead of the equivalent MenuHeaders.  This will cause the
  6792.                appropriate menu processing to take place, but nothing will
  6793.                be displayed on-screen.
  6794.  
  6795.                However, if you REALLY need to disable even the
  6796.                SilentMenuHeaders, for whatever reason, you must modify your
  6797.                MenuFile to compensate for this.  Due to the flexible way
  6798.                that Maximus handles menus, you need to inform the menu
  6799.                handler that a particular menu represents a message/file
  6800.                area so it can read certain pieces of information from
  6801.                AREA.DAT.  Since the MenuHeader statement usually informs
  6802.                Maximus of this, disabling it will make Maximus think that
  6803.                the menu just represents a normal area.  The solution for
  6804.                this is to place either the '[message]' and '[file]' MECCA
  6805.                tokens at the top of the custom MenuFile, depending on the
  6806.                type of area (message or file) you want the menu to
  6807.                represent.  These tokens must be used before any of the
  6808.                message- specific tokens (such as '[msg_cname]') are used. 
  6809.                The [message] or [file] token only needs to be used when a
  6810.                message area is first entered - this means that you can
  6811.  
  6812.  
  6813.                    Maximus 2.02 System Operations Manual - Page 121
  6814.  
  6815.  
  6816.  
  6817.                place the [message] or [file] token in the custom HeaderFile
  6818.                as well, although it will work equally well in the MenuFile.
  6819.  
  6820.           *    When designing a custom menu with an input prompt at the
  6821.                bottom, you may have some trouble getting the cursor to stop
  6822.                at the appropriate place.  Most text editors automatically
  6823.                insert a carriage return after the last line of the file,
  6824.                and since Maximus reads the entire file, this will cause the
  6825.                cursor to skip down to the next line after the entire file
  6826.                is displayed.  There are two solutions to this: the first is
  6827.                to use a text editor that does not insert a carriage return
  6828.                at the end of the file.  The other solution, if you are
  6829.                using a .MEC file to create the menu, is to insert a
  6830.                '[quit]' token where you want the cursor to stop.  As soon
  6831.                as Maximus encounters this token, it will stop displaying
  6832.                the file, without displaying an extra carriage return.  On
  6833.                the other hand, if you are creating the MenuFile manually,
  6834.                you can insert the compiled equivalent directly into the
  6835.                text, which is '^oQ'.  (Control-O and then a capital letter
  6836.                'Q'.).  This has the same affect as would the [quit] token,
  6837.                and this token will caused Maximus to behave in the desired
  6838.                fashion.
  6839.  
  6840.  
  6841.  
  6842.  
  6843.  
  6844.  
  6845.  
  6846.  
  6847.  
  6848.  
  6849.  
  6850.  
  6851.  
  6852.  
  6853.  
  6854.  
  6855.  
  6856.  
  6857.  
  6858.  
  6859.  
  6860.  
  6861.  
  6862.  
  6863.  
  6864.  
  6865.  
  6866.  
  6867.  
  6868.                    Maximus 2.02 System Operations Manual - Page 122
  6869.  
  6870.  
  6871.  
  6872.                              WAITING FOR CALLER SUBSYSTEM
  6873.  
  6874.           Max 2.02 supports an internal Waiting for Caller (WFC) module. 
  6875.           This module allows Max to initialize the modem, wait for a call,
  6876.           answer the phone, and pass control to the main BBS.  WFC can be
  6877.           used on all nodes of a system, on selected nodes, or on no nodes. 
  6878.           Nodes which do NOT use WFC will require an external program to
  6879.           answer the phone, such as BinkleyTerm or FrontDoor.
  6880.  
  6881.  
  6882.           Starting WFC
  6883.  
  6884.           The WFC module is activated with the '-w' command line switch. 
  6885.           Optionally, the '-p' and '-b' switches can be used to override
  6886.           the starting com port and baud rate.  If you specify just '-w',
  6887.           WFC will start up using the com port and baud rate specified in
  6888.           the control file.
  6889.  
  6890.           Before using WFC, you must make sure that the modem strings in
  6891.           MAX.CTL are configured correctly.  The distribution version of
  6892.           Max comes with a modem configuration which supports most Hayes-
  6893.           compatible modems.  However, if the WFC module does not work out
  6894.           of the box, you may have to fiddle with certain strings (such as
  6895.           the "Answer" and "Init" strings) to make it perform as expected.
  6896.  
  6897.           In particular, the distribution MAX.CTL defaults to using "manual
  6898.           answer".  This means that, instead of telling the modem to
  6899.           automatically answer the phone when it detects a ring, Max will
  6900.           take care of ring checking itself.  This means that the phone
  6901.           will only be answered when Max is ready to take a call, which is
  6902.           the preferred method of doing things.
  6903.  
  6904.           However, this manual phone answering may not be compatible with
  6905.           all systems.  If you wish to disable manual answering, change the
  6906.           last part of the Init string to read "S0=1" instead of "S0=0",
  6907.           and comment out the "Answer" string.  This will instruct your
  6908.           modem to answer the phone automatically, which may work better on
  6909.           several brands of semi-compatible modems.
  6910.  
  6911.  
  6912.           Screen Display and SysOp Keys
  6913.  
  6914.           When WFC starts up, assuming that you are using Video IBM or
  6915.           Video BIOS, you will see four multicolored windows displayed on
  6916.           the screen.
  6917.  
  6918.           The first window, "Status", gives you the time until the next
  6919.           event, the current modem status, the number of calls made to your
  6920.  
  6921.  
  6922.  
  6923.                    Maximus 2.02 System Operations Manual - Page 123
  6924.  
  6925.  
  6926.  
  6927.           system (both today and in total), and the name of the last caller
  6928.           on your system.
  6929.  
  6930.           The second window, "Modem Responses", displays a scrolling list
  6931.           of past responses from the modem.  In this window, Max will print
  6932.           out result codes send from the modem.
  6933.  
  6934.           The third window, "Current Activity", is a scrolling window which
  6935.           displays log messages as they appear.
  6936.  
  6937.           The fourth window, "SysOp Keys", contains descriptions for all of
  6938.           the keys which can be pressed while in WFC mode.
  6939.  
  6940.           Pressing <Alt-K> will start a local copy of the BBS.  Maximus
  6941.           will take the phone off-hook and then commence the normal log-on
  6942.           procedure.
  6943.  
  6944.           Pressing <Alt-J> will start an OS shell.  You can do file
  6945.           maintenance, make changes to your batch files, or perform other
  6946.           small changes while in the shell.  Type 'exit' to return to
  6947.           Maximus.  Maximus will take the modem off-hook while you are in
  6948.           the shell.
  6949.  
  6950.           Pressing <Alt-X> will take the system down.  Max will put the
  6951.           phone off-hook, clear the screen, and exit to your batch file
  6952.           with errorlevel 1.
  6953.  
  6954.           For more information on installing WFC, please see the section in
  6955.           the installation entitled "Supporting Remote Callers".
  6956.  
  6957.           When using the internal WFC, Max can also handle "external
  6958.           events".  External events are used to run a particular program at
  6959.           a given time, usually by exiting to your batch file with an
  6960.           errorlevel.  Events are covered in detail in the EVENTS.BBS
  6961.           section of the Maximus Technical Reference Manual.
  6962.  
  6963.  
  6964.  
  6965.  
  6966.  
  6967.  
  6968.  
  6969.  
  6970.  
  6971.  
  6972.  
  6973.  
  6974.  
  6975.  
  6976.  
  6977.  
  6978.                    Maximus 2.02 System Operations Manual - Page 124
  6979.  
  6980.  
  6981.  
  6982.                             EXPIRATION/SUBSCRIPTION SYSTEM
  6983.  
  6984.           Maximus supports a full-fledged user subscription and expiry
  6985.           system.  Callers can be set to "expire" based on the current date
  6986.           or time used (in minutes).  When a caller expires, Max can
  6987.           optionally demote that caller to a lower priv level, hang up, or
  6988.           delete that user's account.
  6989.  
  6990.           To access the user subscription system, start up the Max user
  6991.           editor with "max -u".  Until you get the hang of Max's
  6992.           subscription system, create a new user for testing purposes. 
  6993.           (The "A" key will append a blank record to the end of the user
  6994.           file.)
  6995.  
  6996.           To create a subscriber, first select the "," key; this allows you
  6997.           to set the "expire by" field.  If you want the user's account to
  6998.           expire after a certain date, select "D".  If you want the user's
  6999.           account to expire after a certain number of minutes, press "M". 
  7000.           If you do not want the user to expire at all, press "N".
  7001.  
  7002.           Next, press "." to set the expiry action field.  If you want Max
  7003.           to hang up and delete that user's account, press "A".  If you
  7004.           want Max to demote that user to a lower priv level, press "D" and
  7005.           enter the priv level.  If you do not want any action to take
  7006.           place, press "N".
  7007.  
  7008.           Finally, press "<" to set the expiry date/time.  If you selected
  7009.           DATE for the "expire by" field, you can enter the expiry date of
  7010.           the user here.  Otherwise, if you selected MINUTES, you can enter
  7011.           the number of on-line minutes to give the specified user.
  7012.  
  7013.           After setting up the expiry controls for a user, the subscription
  7014.           system is completely self-maintaining.  If a user expires, that
  7015.           user's account will be modified accordingly whenever that user
  7016.           logs on again.
  7017.  
  7018.           In addition, when a user expires due to the current date, the
  7019.           file \MAX\MISC\XPDATE.BBS will be shown.  When a user expires due
  7020.           to running out of minutes, the file \MAX\MISC\XPTIME.BBS will be
  7021.           shown.
  7022.  
  7023.  
  7024.  
  7025.  
  7026.  
  7027.  
  7028.  
  7029.  
  7030.  
  7031.  
  7032.  
  7033.                    Maximus 2.02 System Operations Manual - Page 125
  7034.  
  7035.  
  7036.  
  7037.                                  MULTILINGUAL SUPPORT
  7038.  
  7039.           Maximus 2.02 includes full-fledged multilingual support.  Up to
  7040.           eight different languages can be defined in MAX.CTL, and users
  7041.           can switch to any of these languages at any time.  The language
  7042.           files themselves encompass almost everything that Max displays to
  7043.           the user, including prompts, system messages and command keys.  A
  7044.           separate language file can be created to use Oui and Non instead
  7045.           of Yes and No; even the keystrokes for various options can be
  7046.           changed.
  7047.  
  7048.           Language files are divided into two distinct sections.  Each
  7049.           language file has a set of strings to be displayed to the USER,
  7050.           and each also has a second set of strings to be displayed to the
  7051.           SYSOP.  By default, the SysOp interface always uses the FIRST
  7052.           language file defined in LANGUAGE.CTL, regardless of the language
  7053.           currently in use by the user.  This means that the user can be
  7054.           walking through the menus in German, but the SysOp will still be
  7055.           able to read the pop-up menus in English.  Max also comes with a
  7056.           second language file, AMERICAN.MAD, which was modified to handle
  7057.           certain American spellings.
  7058.  
  7059.           Max's multilingual support can be used to define different
  7060.           prompts, menus and custom display files for each individual
  7061.           language.  Prompts are all handled by the language file itself,
  7062.           simply by editing the appropriate <langname>.MAD file.  However,
  7063.           menus must be specially designed by the SysOp, since a separate
  7064.           set of menus should normally be used for each language. 
  7065.           Likewise, most display files should be changed to accommodate
  7066.           each new language.
  7067.  
  7068.           The principal method of supporting alternate menus and display
  7069.           files is through the "%Y" external program translation character. 
  7070.           The "%Y" character translates to the user's current language
  7071.           number, with 0 being the FIRST language defined in MAX.CTL, 1
  7072.           being the second, and so on.  "%Y" can be used in many places,
  7073.           including the "First Menu" option in MAX.CTL, all Display_Menu
  7074.           options, and also as "+Y" in all Display_File commands.  The
  7075.           careful placement of the "%Y" token can be used to handle most of
  7076.           Max's multilingual support.
  7077.  
  7078.           For example, if you had the following language statements in
  7079.           LANGUAGE.CTL:
  7080.  
  7081.                Language  English
  7082.                Language  Sanskrit
  7083.  
  7084.           using a "First Menu MAIN%Y" statement in MAX.CTL would cause
  7085.           "MAIN0" to be displayed for callers who selected the English
  7086.  
  7087.  
  7088.                    Maximus 2.02 System Operations Manual - Page 126
  7089.  
  7090.  
  7091.  
  7092.           language, and "MAIN1" would be shown to callers who selected the
  7093.           Sanskrit language.
  7094.  
  7095.           This methodology can also be applied to display files; you can
  7096.           either use a "Display_File D:\Path\File%Y" to display different
  7097.           physical files, or the "[iflang]" MECCA token can be used within
  7098.           an individual display file to make decisions based on the current
  7099.           language.
  7100.  
  7101.           By default, Max stores a user's language preference in the user
  7102.           file.  However, if you want Max to prompt the user for a new
  7103.           language each time he/she logs on, you can do this by placing the
  7104.           token "[menu_cmd chg_language]" at the top of WELCOME.MEC.
  7105.  
  7106.  
  7107.  
  7108.  
  7109.  
  7110.  
  7111.  
  7112.  
  7113.  
  7114.  
  7115.  
  7116.  
  7117.  
  7118.  
  7119.  
  7120.  
  7121.  
  7122.  
  7123.  
  7124.  
  7125.  
  7126.  
  7127.  
  7128.  
  7129.  
  7130.  
  7131.  
  7132.  
  7133.  
  7134.  
  7135.  
  7136.  
  7137.  
  7138.  
  7139.  
  7140.  
  7141.  
  7142.  
  7143.                    Maximus 2.02 System Operations Manual - Page 127
  7144.  
  7145.  
  7146.  
  7147.                                    QWK MAIL PACKER
  7148.  
  7149.           Through the reader menu, Max allows users to download mail for
  7150.           off-line reading.  Max supports the popular QWK format, so
  7151.           readers such as Deluxe2, Qmail, SLMR and OFFLINE can all be used
  7152.           to read the downloaded mail packets.
  7153.  
  7154.  
  7155.           Configuration
  7156.  
  7157.           The QWK mail packer is largely self-maintaining, since it uses
  7158.           most of the Max configuration files to a full extent.  However,
  7159.           you do have to edit READER.CTL at least once to configure it for
  7160.           your system.
  7161.  
  7162.           The first keyword to change is the "Packet Name" option.  You
  7163.           should set this to a name describing your BBS, eight characters
  7164.           or less, with no spaces.  Maximus will use this as the base
  7165.           filename when sending QWK mail packets.
  7166.  
  7167.           You should also configure your phone number properly, and also
  7168.           make sure that you have all of the archivers defined in
  7169.           COMPRESS.CFG.
  7170.  
  7171.           For more information on configuring the QWK mail packer, please
  7172.           see the section in the installation entitled "Configuring the QWK
  7173.           Mail Packer".
  7174.  
  7175.  
  7176.           Bulletins, News Files and File Lists
  7177.  
  7178.           In addition to mail, the QWK format also supports bulletins, news
  7179.           files and new file lists.  Max supports these files in an
  7180.           extremely simple manner; anything which exists in the \MAX\OLR
  7181.           directory will be packed up with each mail packet.
  7182.  
  7183.           The QWK format defines several standard files which will be
  7184.           displayed to the user.  To use these features, simply place a
  7185.           file with the specified name(s) in the \MAX\OLR directory.
  7186.  
  7187.           HELLO          Displayed when the reader first starts up.  This
  7188.                          is typically the equivalent of your WELCOME.BBS
  7189.                          screen.  This should be ANSI only; no AVATAR or
  7190.                          MECCA codes allowed.
  7191.  
  7192.           NEWS           Your BBS news file.  This is usually available as
  7193.                          an option from the QWK reader's main menu.  This
  7194.                          is normally a flat ASCII with no graphics.
  7195.  
  7196.  
  7197.  
  7198.                    Maximus 2.02 System Operations Manual - Page 128
  7199.  
  7200.  
  7201.  
  7202.           GOODBYE        Displayed when the reader closes the packet from
  7203.                          your BBS.  This file can include ANSI graphics.
  7204.  
  7205.           BLT-1.1        Bulletin file 1.  This is usually displayed as an
  7206.                          option on the reader's main menu.  In this case,
  7207.                          the file extension is ".1", but you can use
  7208.                          anything from ".1" to ".99" to provide up to 99
  7209.                          different bulletins.
  7210.  
  7211.           NEWFILES.DAT   This file can contain a new files listing for your
  7212.                          BBS.  Max will not generate this for you, but it
  7213.                          is easy to have your file list generator create a
  7214.                          copy of a new files list in the off-line reader
  7215.                          directory.
  7216.  
  7217.           Again, all of these files are optional.  However, since Max packs
  7218.           up everything in the \MAX\OLR directory when creating a packet
  7219.           for the remote system, simply placing one of the above files in
  7220.           that directory will cause it to be displayed on the remote side.
  7221.  
  7222.  
  7223.           Remote Message Packing
  7224.  
  7225.           The default Max configuration includes an "off-line reader" menu,
  7226.           but mail can also be packed from the regular message menu.  All
  7227.           of the QWK mail packing functionality is built into the Browse
  7228.           command; in fact, the "Download" command on the reader menu is a
  7229.           simple macro which invokes the Browse command.
  7230.  
  7231.           The default Download command passes the options "t/n/p" to
  7232.           Browse.  This requests a scan of T)agged areas, N)ew messages,
  7233.           and P)ack in QWK format.  Obviously, with the flexibility of the
  7234.           Browse command, many more operations can be performed.  A
  7235.           selective download can be performed by using the search function
  7236.           (complete with AND/OR operators), and messages could be packed
  7237.           from only the current area, as opposed to all areas on the
  7238.           system.  Since the QWK packer is seamlessly integrated with the
  7239.           rest of the Browse logic, an infinite number of combinations are
  7240.           possible.
  7241.  
  7242.           When selecting the Pack option from the Browse menu, Max will
  7243.           gather all of the specified messages, print out how many it
  7244.           captured, and find out if the user wants to download them.  If
  7245.           so, Max will compress the packet with the user's default
  7246.           archiving program, count to ten (giving the user a chance to
  7247.           abort), and then send the file using the default transfer
  7248.           protocol.
  7249.  
  7250.  
  7251.  
  7252.  
  7253.                    Maximus 2.02 System Operations Manual - Page 129
  7254.  
  7255.  
  7256.  
  7257.           The reader menu also includes an upload option; this allows the
  7258.           user to upload a .REP file (created by one of the off-line
  7259.           readers).  This .REP file will be decompressed based on the
  7260.           information given in COMPRESS.CFG, and messages contained within
  7261.           will be tossed to the appropriate message areas.
  7262.  
  7263.  
  7264.           Local Mail Packing
  7265.  
  7266.           In addition to remote use, the QWK routines can also be used in
  7267.           local mode.  After compressing a packet, Max will simply leave
  7268.           the packed QWK file in the off-line reader directory.  (By
  7269.           default, the file will be in the \MAX\OLR\NODExx\ directory,
  7270.           where 'xx' is the current task number).  Max normally deletes the
  7271.           QWK file after it is sent, but Max will leave it there for a
  7272.           local session.
  7273.  
  7274.           In local mode, if you want to "upload" a .REP packet, select the
  7275.           Upload option from the reader menu.  If the caller is local, Max
  7276.           will prompt for the path and filename of the .REP packet.  Enter
  7277.           the location of the packet (as created by your off-line reader),
  7278.           and Max will then decompress and toss that packet.
  7279.  
  7280.  
  7281.           Unattended Mail Packing ("Vacation Saver")
  7282.  
  7283.           In conjunction with the "-j" command-line parameter, local mail
  7284.           packing is an important feature.  At predefined intervals, you
  7285.           can set up your batch files to call Max with the "-j" command
  7286.           line switch.  This switch can be used to log on as a certain
  7287.           user, execute a download command, log off, and have your batch
  7288.           files copy the created QWK packet to a file area.
  7289.  
  7290.           By doing this, you can pack mail "in advance" for certain users,
  7291.           or use it to save mail for yourself while you are on vacation. 
  7292.           Since the packing process is completely controlled by the
  7293.           keystrokes you specify for the -j switch, almost any type of mail
  7294.           download is possible.
  7295.  
  7296.           For example, if the keystrokes required to get from the main menu
  7297.           to the reader menu, download a packet and log off were
  7298.           "n;o;d;y;m;g", the following command-line would automatically
  7299.           start up Max, pack mail for the specified user, and then log off.
  7300.  
  7301.                max "-jJoe User;Y;Password;n;o;d;y;m;g"
  7302.  
  7303.           Note!  If your log-on sequence includes a "Press ENTER to
  7304.           continue" prompt, you should use the "|" character where you
  7305.           would normally press the <enter> key.
  7306.  
  7307.  
  7308.                    Maximus 2.02 System Operations Manual - Page 130
  7309.  
  7310.  
  7311.  
  7312.           In addition, you can create multiple lines in your batch file for
  7313.           multiple users, as long as you remember to copy the packet from
  7314.           \MAX\OLR\NODExx into a safe place after each mail pack.
  7315.  
  7316.  
  7317.           NetMail Messages
  7318.  
  7319.           Since the QWK format was not designed with NetMail messages in
  7320.           mind, you must follow a special convention when reading and
  7321.           replying to NetMail messages in a QWK reader.  When you download
  7322.           messages from your NetMail area, the first line of each message
  7323.           will look like this:
  7324.  
  7325.           From: <addr>
  7326.  
  7327.           where <addr> is the 4D network address of the sender.  Since
  7328.           there's no place in the QWK header to store the origination
  7329.           address, Max places this information in the message body instead.
  7330.  
  7331.           If you wish to create or reply to a NetMail message, Max expects
  7332.           to see a "To: <addr>" line as the FIRST line in the message body. 
  7333.           For example, to send a NetMail message to 1:123/456, the first
  7334.           line of your message should look like this:
  7335.  
  7336.           To: 1:123/456
  7337.  
  7338.           Note that the "To:" text will be stripped before the message is
  7339.           written to the Max message base, so your QWK messages will look
  7340.           like normal messages to everyone else.
  7341.  
  7342.           When replying to a message, there's an easy way to set the
  7343.           destination address; simply quote the original message, then
  7344.           change the "From:" line to a "To:" (after removing any quoting
  7345.           marks).  This ensures that the destination address is correct,
  7346.           and Max will make sure that you reply is sent to its intended
  7347.           destination.
  7348.  
  7349.  
  7350.  
  7351.  
  7352.  
  7353.  
  7354.  
  7355.  
  7356.  
  7357.  
  7358.  
  7359.  
  7360.  
  7361.  
  7362.  
  7363.                    Maximus 2.02 System Operations Manual - Page 131
  7364.  
  7365.  
  7366.  
  7367.                               MISCELLANEOUS INFORMATION
  7368.  
  7369.           This chapter is for miscellaneous information which did not fit
  7370.           anywhere else in this documentation.
  7371.  
  7372.  
  7373.           Filename Specifications
  7374.  
  7375.           Wherever you specify a filename, make sure to specify a FULL
  7376.           path, including drive specifier and leading backslash.  For speed
  7377.           reasons, Maximus changes the current directory as it executes. 
  7378.           This mean that you can never assume anything about the current
  7379.           directory.  SILT will try to compensate for this, but cannot do
  7380.           so in all circumstances.
  7381.  
  7382.  
  7383.           Hard-Coded Filenames
  7384.  
  7385.           Maximus uses several hard-coded filenames, whose names are not
  7386.           changeable:
  7387.  
  7388.                <areaname>.DSC:  For Squish areas only. This file will be
  7389.                displayed to a user when entering an area, only if that
  7390.                user's lastread pointer is set to zero.  This is useful for
  7391.                giving a brief description of a message area, including the
  7392.                topics allowed and other appropriate information.  For *.MSG
  7393.                areas, see DESCRIPT.BBS.
  7394.  
  7395.                <areaname>.SQR:  For Squish areas only.  This file can be
  7396.                placed in the subdirectory containing the messages for that
  7397.                area.  <areaname> is the same as the name for the Squish
  7398.                message database (defined by Matrix, Local, Echomail, or
  7399.                Conference keyword in MSGAREA.CTL).  It will be displayed to
  7400.                callers each time they enter a message area.  For *.MSG
  7401.                areas, see RULES.BBS.
  7402.  
  7403.                <areaname>.SQX:  For Squish areas only.  This file will be
  7404.                displayed to a user who attempts to enter a message in a
  7405.                read-only area.
  7406.  
  7407.                ACTIVExx.BBS:  This file is created by Maximus whenever a
  7408.                user logs onto a given node.  'xx' is the hexadecimal task
  7409.                number of the node in question.  This file will be deleted
  7410.                when the user logs off.
  7411.  
  7412.                ATTRIB.BBS:  This is the file displayed to users who press a
  7413.                "?" at the attribute prompt in the full-screen message entry
  7414.                header.  This file explains the various attributes
  7415.  
  7416.  
  7417.  
  7418.                    Maximus 2.02 System Operations Manual - Page 132
  7419.  
  7420.  
  7421.  
  7422.                available, such as private, crash, hold, and so on.  This
  7423.                file is located in the \MAX\MISC directory.
  7424.  
  7425.                BADUSER.BBS:  If a file named BADUSER.BBS resides in the
  7426.                main Maximus directory, Maximus can use it as a screen when
  7427.                a new user logs on, to keep out users with unwanted names. 
  7428.                This file is a simple ASCII text file, containing a list of
  7429.                names not to be allowed on the BBS, one to a line.  Each
  7430.                name listed in the file will be matched to either the first,
  7431.                last, or the entire name of the user.  If Maximus finds a
  7432.                match, then it will try to display a file called
  7433.                BAD_USER.BBS in your miscellaneous directory, and then hang
  7434.                up.  This file should be located in the \MAX directory.
  7435.  
  7436.                BLT-1.1 - BLT-1.99:  Bulletins to be displayed to the users
  7437.                of the QWK packer.  Please see the section entitled "QWK
  7438.                Mail Packer" for more information.  This file should be
  7439.                located in the \MAX\OLR directory.
  7440.  
  7441.                BROWSE.BBS:  The help file for the Browse command.  This
  7442.                file should be located in the \MAX\MISC directory.
  7443.  
  7444.                CHATHELP.BBS:  This is the help file which will be displayed
  7445.                inside the multi-node chat.  It is located in the Maximus
  7446.                MISC\ directory.
  7447.  
  7448.                CHATPAGE.BBS:  This file is displayed to the user when a
  7449.                chat request is received from another node.  Maximus will
  7450.                display the "You are being paged ..." message first,
  7451.                followed by this file.  For example, this file could be used
  7452.                to display information on how to access the Answer Page
  7453.                command.  CHATPAGE.BBS should be located in the Misc
  7454.                directory.
  7455.  
  7456.                CHG_SENT.BBS:  This is the help file displayed when a user
  7457.                tries to edit a message which has already been sent, packed,
  7458.                or scanned as EchoMail.  CHG_SENT.BBS should be located in
  7459.                the Misc  directory.
  7460.  
  7461.                CHG_NO.BBS:  This is the help file displayed when a user
  7462.                tries to edit a message which was written by someone else. 
  7463.                It is located in the \MAX\MISC directory.
  7464.  
  7465.                DESCRIPT.BBS:  If this file exists in a *.MSG directory, the
  7466.                contents will be displayed to users who enter this area, and
  7467.                whose lastread pointer is set to zero.  For Squish areas,
  7468.                see the comments for <areaname>.DSC.  To display a file to
  7469.                all users who enter an area (regardless of lastread pointer
  7470.                settings), see also RULES.BBS
  7471.  
  7472.  
  7473.                    Maximus 2.02 System Operations Manual - Page 133
  7474.  
  7475.  
  7476.  
  7477.                EVENTSxx.BBS:  The ASCII event control file used by Max's
  7478.                event controller, where 'xx' is the current node number. 
  7479.                See the section in the installation entitled "Events and
  7480.                Yelling" for more information, and also see the "EVENT FILE
  7481.                CONFIGURATION" section in the Maximus Technical Reference
  7482.                Manual.  These files should be located in the Max root
  7483.                directory.
  7484.  
  7485.                EVENTSxx.DAT:  The compiled version of the Maximus event
  7486.                file, where 'xx' is the current node number.  The ASCII
  7487.                event file, EVENTSxx.BBS, is compiled by MAX.EXE at runtime. 
  7488.                These files should be located in the Max root directory.
  7489.  
  7490.                EXCBYTES.BBS:  This file will be displayed to a user who
  7491.                attempts to download too many kilobytes in one session. 
  7492.                (Maximus will display this after printing "That would exceed
  7493.                your daily download limit.")  This file should be located in
  7494.                the \MAX\MISC directory.
  7495.  
  7496.                EXCRATIO.BBS:  This file will be displayed to a user who
  7497.                attempted to download a file that would exceed his/her file
  7498.                download ratio.  (Maximus will display this file after
  7499.                printing "That would exceed your download ratio.")  This
  7500.                file should be located in the \MAX\MISC directory.
  7501.  
  7502.                EXCTIME.BBS:  This file will be displayed to a user who
  7503.                attempted to download a file that would exceed his/her time
  7504.                limit.  (Maximus will display this file after printing "That
  7505.                would exceed your time limit.")  This file should be located
  7506.                in the \MAX\MISC directory.
  7507.  
  7508.                FILES.BBS:  This is the name of the ASCII file listing in
  7509.                each file directory.  For more information on creating a
  7510.                FILES.BBS, please see the section in the installation
  7511.                entitled "Maintaining File Areas".
  7512.  
  7513.                FILES.DAT:  This is the name of the compiled file name
  7514.                listing in each file directory.  The FB utility creates
  7515.                FILES.DAT and several other files from the master FILES.BBS.
  7516.  
  7517.                FILES.DMP:  This is the name of the compiled file
  7518.                description listing in each file directory.  The FB utility
  7519.                creates FILES.DMP and several other files from the master
  7520.                FILES.BBS.
  7521.  
  7522.                FILES.IDX:  This is the name of the compiled file index in
  7523.                each file directory.  The FB utility creates FILES.IDX and
  7524.                several other files from the master FILES.BBS.
  7525.  
  7526.  
  7527.  
  7528.                    Maximus 2.02 System Operations Manual - Page 134
  7529.  
  7530.  
  7531.  
  7532.                FILE_BAD.BBS:  This file is displayed when an uploaded file
  7533.                fails the upload virus check.  Please see the MAX.CTL
  7534.                reference for more information on the "Upload Check Virus"
  7535.                keyword.  This file should be located in the \MAX\MISC
  7536.                directory.
  7537.  
  7538.                FILE_OK.BBS:  This file is displayed when an uploaded file
  7539.                passes the upload virus check.  Please see the MAX.CTL
  7540.                reference for more information on the "Upload Virus Check"
  7541.                keyword.  This file should be located in the \MAX\MISC
  7542.                directory.
  7543.  
  7544.                GOODBYE:  This is the name of the file displayed (by the
  7545.                off-line reader) to a QWK user who closes your system's mail
  7546.                packet.  This file should be located in the \MAX\OLR
  7547.                directory.
  7548.  
  7549.                HELLO:  This is the name of the file displayed (by the off-
  7550.                line reader) to a QWK user who opens your system's mail
  7551.                packet.  This file should be located in the \MAX\OLR
  7552.                directory.
  7553.  
  7554.                LASTUSxx.BBS:  This file is created by Maximus as a record
  7555.                of the last caller on the system.  In addition, this file is
  7556.                used by Maximus-specific door programs to obtain information
  7557.                about the user who is currently on-line.  This file simply
  7558.                contains a copy of that user's user record, with the "time
  7559.                remaining" and "baud rate" fields filled out appropriately.
  7560.  
  7561.                MAXFILES.IDX:  This is the system-wide file index, as
  7562.                created by FB.  This file is used for performing global
  7563.                downloading and upload dupe checking.
  7564.  
  7565.                MTAG.BBS:  This is a binary file used by Maximus to store
  7566.                message area T)agging information for each individual
  7567.                caller.  This file is located in the \MAX directory.
  7568.  
  7569.                NAMES.MAX:  Max has a feature similar to FrontDoor's
  7570.                NAMES.FD.  If you place a file called NAMES.MAX in your
  7571.                system directory, you can use it as an "alias" file for
  7572.                entering NetMail messages.  NAMES.MAX has the following
  7573.                format, one alias definition to a line:
  7574.            
  7575.                     <alias>,<name>,<address> [,<subject>]
  7576.            
  7577.                You can have any number of aliases listed in NAMES.MAX.  If
  7578.                Max spots a message addressed to "alias" (which can be done
  7579.                by entering the name directly at the prompt, when doing
  7580.                carbon copies, etc.), the message will be automatically
  7581.  
  7582.  
  7583.                    Maximus 2.02 System Operations Manual - Page 135
  7584.  
  7585.  
  7586.  
  7587.                readdressed to "name".  <subject> is optional; it can be
  7588.                used to enter a default subject for the message.  Example: 
  7589.            
  7590.                     jdh,Jesse David Hollington,1:225/1
  7591.                     adf,Andrew Farmer,1:163/115
  7592.                     sjd,Scott Dudley,1:249/106
  7593.                     afx,Areafix,1:106/116,gronk
  7594.                     jimbo,Jim Jones,1:106/114.5
  7595.  
  7596.                Entering the initials in the left column instructs Max to
  7597.                readdress the message to the appropriate person, using the
  7598.                specified address.
  7599.  
  7600.                If a "*" is placed at the beginning of an alias definition,
  7601.                that definition can only be used by callers with a priv of
  7602.                SysOp.  This may be useful for protecting Areafix and Raid
  7603.                passwords.  The NAMES.MAX file should be located in the \MAX
  7604.                directory.
  7605.  
  7606.                NEWFILES.DAT:  This file is displayed to a QWK user (by the
  7607.                off-line mail reader) when that user requests a new file
  7608.                listing from your BBS.  Please see the section entitled "QWK
  7609.                Mail Packer" for more information.  This file should be
  7610.                located in the \MAX\OLR directory.
  7611.  
  7612.                NEWS:  This is displayed to a QWK user (by the off-line mail
  7613.                reader) when that user requests a news file display from
  7614.                your BBS.  Please see the section of the documentation
  7615.                entitled "QWK Mail Packer" for more information.  This file
  7616.                should be located in the \MAX\OLR directory.
  7617.  
  7618.                NOTIN.BBS: When a user yells and the sysop does not respond,
  7619.                Maximus will look for this file in the Maximus MISC\
  7620.                directory.  If it exists, then this file will be displayed. 
  7621.                If it does not exist, Maximus will display the standard
  7622.                'Sorry, there's no answer'.  (Compare to YELL.BBS.)
  7623.  
  7624.                RAWDIR.BBS: If a file of this name exists in a file area
  7625.                directory, it will be displayed to the user when s/he
  7626.                attempts a R)aw directory command.  It will be displayed
  7627.                AFTER the command is selected from the menu, but BEFORE the
  7628.                'Enter mask:' prompt.
  7629.  
  7630.                READONLY.BBS: If this file exists in a read-only message
  7631.                area, and a user tries to enter a message, then this file
  7632.                will be displayed, as opposed to the built-in, "canned"
  7633.                message which Maximus normally displays.
  7634.  
  7635.  
  7636.  
  7637.  
  7638.                    Maximus 2.02 System Operations Manual - Page 136
  7639.  
  7640.  
  7641.  
  7642.                RESTARxx.BBS:  This file is created by Maximus (where 'xx'
  7643.                is the current node number) when performing an [xtern_erlvl]
  7644.                exit.  This file is used to store state information about
  7645.                the current caller, and it was designed to put Maximus back
  7646.                exactly where it was before the xtern_erlvl was performed. 
  7647.                This file is deleted by Max after restarting with the -r
  7648.                switch.  Also, this file can be used to change some
  7649.                information which is normally not modifiable by external
  7650.                programs, such as the "time user logged on system" field,
  7651.                the current menu, and more.  This file is located in the
  7652.                \MAX directory.
  7653.  
  7654.                RULES.BBS:  When placed in a *.MSG directory, Max will
  7655.                display this file to all callers who access this area.  For
  7656.                Squish areas, see <areaname>.SQR.  To display a file to
  7657.                callers only once, see DISPLAY.BBS and <areaname>.DSC.
  7658.  
  7659.                TAG_FILE.BBS:  This is the help file for the file area Tag
  7660.                command.  This file is located in the \MAX\MISC directory.
  7661.  
  7662.                TAG_MSG.BBS:  This is the help file for the message area Tag
  7663.                command.  This file is located in the \MAX\MISC directory.
  7664.  
  7665.                TIMEUP.BBS:  This file is displayed to callers when their
  7666.                time limits expire.  This message will be displayed after
  7667.                Max prints "TIME LIMIT."  This file is located in the
  7668.                \MAX\MISC directory.
  7669.  
  7670.                TUNES.BBS:  This is the file referred to by the 'Uses Tunes'
  7671.                command in MAX.CTL.  This filename is not hardcoded, but
  7672.                several utilities look for it in the \MAX directory.
  7673.  
  7674.                WHY_ANSI.BBS:  This is the help file for the "Want ANSI
  7675.                [Y,n,?]" question at log-on.  This file is located in the
  7676.                \MAX\MISC directory.
  7677.  
  7678.                WHY_FB.BBS:  This is the help file for the "Goodbye [Y,n,?]"
  7679.                question at log-off.  This explains to callers why they
  7680.                should leave feedback to the system operator.  This file is
  7681.                located in the \MAX\MISC directory.
  7682.  
  7683.                WHY_FSED.BBS:  This is the help file for the "Want MaxEd
  7684.                [Y,n,?]" question at log-on.  This file is located in the
  7685.                \MAX\MISC directory.
  7686.  
  7687.                WHY_HOT.BBS:  This is the help file for the "Want Hotkeys
  7688.                [Y,n,?]" question at log-on.  This file is located in the
  7689.                \MAX\MISC directory.
  7690.  
  7691.  
  7692.  
  7693.                    Maximus 2.02 System Operations Manual - Page 137
  7694.  
  7695.  
  7696.  
  7697.                WHY_HU.BBS:  This is the help file for the "Goodbye [Y,n,?]"
  7698.                question at log-off.  This file is located in the \MAX\MISC
  7699.                directory.
  7700.  
  7701.                WHY_PC.BBS:  This is the help file for the "Want IBM Chars
  7702.                [Y,n,?]" question at log-on.  This file is located in the
  7703.                \MAX\MISC directory.
  7704.  
  7705.                WHY_PVT.BBS:  This is the help file for the "Private [Y,n]?"
  7706.                question when entering a message in TTY mode.  This file is
  7707.                located in the \MAX\MISC directory.
  7708.  
  7709.                XPDATE.BBS:  This file is displayed when a user's
  7710.                subscription expires due to the current date.  This file
  7711.                should be in the \MAX\MISC directory.
  7712.  
  7713.                XPTIME.BBS:  This file is displayed when a user's
  7714.                subscription expires due to that user's number of on-line
  7715.                minutes.  This file should be in the \MAX\MISC directory.
  7716.  
  7717.                YELL.BBS: When yell is turned off and a user tries to yell
  7718.                for the sysop, Maximus will look for this file in the
  7719.                \MAX\MISC directory.  If it exists, it will display the file
  7720.                to the user.  If it does not exist, Maximus will display the
  7721.                standard 'Yell is turned off' message.
  7722.  
  7723.  
  7724.  
  7725.  
  7726.  
  7727.  
  7728.  
  7729.  
  7730.  
  7731.  
  7732.  
  7733.  
  7734.  
  7735.  
  7736.  
  7737.  
  7738.  
  7739.  
  7740.  
  7741.  
  7742.  
  7743.  
  7744.  
  7745.  
  7746.  
  7747.  
  7748.                    Maximus 2.02 System Operations Manual - Page 138
  7749.  
  7750.  
  7751.  
  7752.                                         INDEX
  7753.  
  7754.           .FIZ                    40, 41     BULLETIN.MEC                92
  7755.           .LZH                        30     cable                       43
  7756.           *.BBS  66, 67, 73, 76, 92, 105     CALLINFO.BBS          110, 111
  7757.           *.CTL                       66     CB chat                37, 120
  7758.           *.MEC                   67, 92     CD-ROM                      74
  7759.           *.MNU                 100, 109     chain            105, 110, 111
  7760.           *.PRM                 100, 105     CHAIN.TXT             110, 111
  7761.           \MAX   10, 11, 24, 44, 51, 60,     chat       4, 13, 14, 37, 116,
  7762.                          66, 67, 89, 95,                       118-120, 133
  7763.                       106, 110-113, 116,     COM2                   54, 108
  7764.                           117, 119, 125,     command line   11, 53, 54, 57,
  7765.                       128-131, 133, 134,                59, 86, 89, 93, 94,
  7766.                                  135-138                  95, 97, 116, 123,
  7767.           \MAX\HLP                    24                                130
  7768.           \MAX\MISC  10, 11, 51, 66, 67,     COMMAND.COM       36, 102, 103
  7769.                       95, 110, 111, 112,     comment     12, 59, 61, 71-73,
  7770.                      117, 119, 125, 133,                       77, 111, 123
  7771.                       134, 135, 137, 138     CONFIG.SYS               45-48
  7772.           80386                       47     ConfMail                 8, 98
  7773.           ACCEM                   79, 80     control file   13, 21, 24, 49,
  7774.           ANSI   10, 11, 23, 24, 33, 47,                50, 53, 55, 62, 64,
  7775.                       51, 66, 81-83, 95,                    70, 73, 77, 94,
  7776.                      107, 110, 114, 121,                      100, 123, 134
  7777.                            128, 129, 137     Copyright            1, 40, 51
  7778.           ANSI.SYS                    47     custom menu                122
  7779.           APPLIC.BBS          10, 66, 67     custom welcome              11
  7780.           APPLIC.MEC              51, 67     CVTUSR          40, 51, 83, 84
  7781.           ARC                      7, 30     DCD                     42, 43
  7782.           Area 0                      71     DESQview            8, 47, 117
  7783.           AREA.DAT   74, 75, 86, 87, 93,     DIP switches                42
  7784.                              97, 99, 121     door interface        110, 111
  7785.           AREAS.BBS                   70     DOOR.SYS              110, 111
  7786.           AUTOEXEC.BAT   45-48, 95, 117,     DORINFO.MEC           110, 111
  7787.                                      118     DOS    4, 7-9, 36, 40, 41, 44,
  7788.           AVATAR     11, 23, 24, 33, 81,                 47, 48, 55-59, 72,
  7789.                        82, 95, 107, 114,                   87, 88, 94, 102,
  7790.                                 121, 128                103, 106, 112, 115,
  7791.           BAD_USER.BBS               133                           117, 118
  7792.           BADUSER.BBS                133     DoubleDOS                8, 47
  7793.           barricade                   16     DSZ                         29
  7794.           BiModem                     29     ECHOTOSS.LOG        60, 98, 99
  7795.           BinkleyTerm     8, 54, 61, 96,     editor       4, 11, 12, 18-21,
  7796.                            103, 115, 123                 23-25, 33, 36, 47,
  7797.           BNU          9, 45, 46, 59, 45                 49-51, 65, 67, 72,
  7798.           BORED               24, 25, 33                73, 77, 79, 82, 89,
  7799.           BUFFERS=                    47                       99, 122, 125
  7800.           BULLETIN.BBS            66, 92     errorlevel  55-60, 62, 63, 99,
  7801.  
  7802.  
  7803.                    Maximus 2.02 System Operations Manual - Page 139
  7804.  
  7805.  
  7806.  
  7807.                       103, 105, 106, 124     locked baud rate            53
  7808.           ERRORLVL.BAT          103, 106     locked port                 46
  7809.           Event                      123     LOGO.BBS                    10
  7810.           extended ASCII          34, 94     LZH      8, 30, 40, 44, 73, 74
  7811.           extended barricades         16     mailchecker             20, 97
  7812.           external program  91, 102-105,     mailer    42, 54, 58, 59, 106,
  7813.                       107, 110-112, 114,                                117
  7814.                                 123, 126     matrix  23, 51, 69, 97-99, 132
  7815.           FEND                         8     MAX.CTL    10, 12, 18, 46, 49,
  7816.           FidoNet  3, 8, 15, 22, 44, 52,                50, 53, 55, 66, 71,
  7817.                              54, 68, 117                  74, 90, 103, 108,
  7818.           FILEAREA.CTL                                  112, 117, 118, 123,
  7819.                Download  20, 29, 30, 34,                      126, 135, 137
  7820.                       38, 70-74, 77, 86,          Address   15, 17, 18, 23,
  7821.                         87, 128-131, 134                  52, 131, 135, 136
  7822.                FileAccess             70          Alias System   10, 32, 84
  7823.                FileInfo               70          FidoUser               18
  7824.                FileList               87          File Date Automatic    73
  7825.                Upload    21, 30, 38, 49,          Name  10, 14, 16, 18, 19,
  7826.                      70, 71, 74, 86, 87,                 21-23, 30, 31, 32,
  7827.                        90, 108, 130, 135                35, 38, 41, 50, 51,
  7828.           FILES.BBS  72-74, 86, 108, 134                55, 56, 59, 64, 66,
  7829.           FILES.DAT              86, 134                67, 77, 79, 81, 84,
  7830.           FILES.DMP              86, 134                 86, 87, 89, 91-94,
  7831.           FILES.IDX              87, 134                   96-98, 100, 103,
  7832.           FILES=                      47                     105, 107, 108,
  7833.           FOSSIL  9, 44, 45, 53, 59, 117                 110-112, 114, 119,
  7834.           FrontDoor  8, 54, 61, 123, 135                     120, 124, 128,
  7835.           FSR                         35                            132-136
  7836.           goto                56-61, 106          No Share.Exe          118
  7837.           guest account               11          Output    79, 81, 91, 92,
  7838.           Hayes        8, 9, 42, 53, 123                            94, 121
  7839.           idiot-proof                 50          Path IPC         118, 119
  7840.           Inquire                     20          Upload Check Dupe      74
  7841.           installation    5, 40, 41, 45,          Uses Leaving          112
  7842.                          46, 49, 51, 78,          Video IBM         82, 123
  7843.                       113, 115-117, 124,     MAX.PRM  90, 94, 100, 105, 116
  7844.                                 128, 134     MaxEd      24, 25, 33, 51, 137
  7845.           Joe SysOp              10, 119     Maximus Help Node            5
  7846.           label   56-58, 60, 61, 79, 106     MECCA  66, 67, 79, 81, 82, 92,
  7847.           LANGUAGE.CTL                34                     102, 106, 107,
  7848.           lastread  20, 83, 93, 132, 133                 110-112, 114, 121,
  7849.           LASTUSER.BBS               110                           127, 128
  7850.           Local  13, 15, 22, 24, 36, 43,     MECCA token     107, 110, 121,
  7851.                      45, 52, 62, 67, 69,                                127
  7852.                      82, 91, 94, 97, 98,          [cls]                 121
  7853.                       99, 107, 108, 111,          [delete]              110
  7854.                            124, 130, 132          [file]           121, 122
  7855.           lock                        65          [message]        121, 122
  7856.  
  7857.  
  7858.                    Maximus 2.02 System Operations Manual - Page 140
  7859.  
  7860.  
  7861.  
  7862.                [msg_cname]           121          End                    68
  7863.                [open]                110          MsgAccess              69
  7864.                [post]                110          MsgInfo                69
  7865.                [quit]           111, 122          MsgName            70, 98
  7866.                [write]          110, 111          Private Only       16, 69
  7867.                [xtern_erlvl]    105, 137          Public and Private     69
  7868.                [xtern_run]           114          Public Only        16, 69
  7869.           Menus   12, 14, 20, 22, 31-33,          Read-Only     16, 69, 70,
  7870.                      35, 49, 50, 64, 66,                           132, 136
  7871.                         76, 81, 96, 100,     MUFFIN                       5
  7872.                      108, 112, 114, 118,     multi-line            116, 120
  7873.                                 121, 126     multi-node chat     4, 13, 14,
  7874.           MENUS.CTL  35, 49, 50, 64, 76,                  37, 118, 119, 133
  7875.                      100, 108, 112, 114,     NetBIOS                    116
  7876.                                 118, 121     NetMail     5, 13, 15, 17, 18,
  7877.                Display_Menu     118, 126                22, 23, 25, 27, 30,
  7878.                HeaderFile            122                 51, 55, 58-60, 69,
  7879.                MenuFile    76, 118, 121,                   88, 99, 131, 135
  7880.                                      122     NEWUSER2.MEC                67
  7881.                MenuHeader       118, 121     nodelist                15, 18
  7882.                Press_Enter           121     non-volatile RAM            42
  7883.                ReRead                114     NOTIN.BBS                  136
  7884.                Statistics    13, 30, 98,     Novell                      48
  7885.                                      121     OECC                         8
  7886.                Version    1, 4-7, 9, 10,     oMMM                        58
  7887.                      13, 15, 41, 62, 63,     Opus    7, 8, 44, 83, 84, 100,
  7888.                          84, 86, 89, 90,                                110
  7889.                      100, 110, 111, 115,     OpusComm              8, 9, 45
  7890.                       116, 121, 123, 134     Oracle          67, 82, 94, 95
  7891.                Xtern_Run        112, 114     OS/2   4, 7-9, 36, 40, 41, 44,
  7892.           modem    9, 42-46, 52-54, 110,                47, 52, 53, 59, 61,
  7893.                                 123, 124                72, 87, 88, 91, 96,
  7894.           MPt                         29                 103, 115, 116, 118
  7895.           MR                      78, 93     packer    38, 58, 60, 77, 128,
  7896.           MS-DOS                8, 9, 47                      129, 133, 136
  7897.           MSGAREA.CTL                        PAK                         30
  7898.                Anonymous OK           16     PCBoard                 8, 118
  7899.                Area       12, 15-23, 25,     phone number   10, 32, 51, 77,
  7900.                       27-29, 31, 38, 61,                      107, 114, 128
  7901.                       64, 65, 68-72, 74,     PMSnoop                     96
  7902.                      75, 86, 87, 89, 90,     printer                     23
  7903.                         93, 96-101, 107,     Printing messages           23
  7904.                           108, 118, 121,     Privilege Level    16, 21, 25,
  7905.                       129-133, 135, 136,                27, 30, 31, 64, 65,
  7906.                                      137                         70, 86, 95
  7907.                EchoMail    3, 5, 15, 16,          AsstSysop  64, 70, 84, 95
  7908.                       55, 58-60, 68, 69,          Clerk              64, 84
  7909.                       70, 78, 88, 97-99,          Disgrace      64, 65, 84,
  7910.                                 132, 133                      112, 114, 121
  7911.  
  7912.  
  7913.                    Maximus 2.02 System Operations Manual - Page 141
  7914.  
  7915.  
  7916.  
  7917.                Extra  6, 41, 58, 64, 77,     security  11, 16, 84, 111, 114
  7918.                                  84, 122     SHARE.EXE         48, 118, 119
  7919.                Favored                64     SILT  31, 50, 69, 71, 90, 100,
  7920.                Hidden         13, 35, 64                           101, 132
  7921.                Limited     2, 64, 79, 95     SIO                 8, 44, 115
  7922.                Normal    16, 22, 31, 50,     SIO.SYS                44, 115
  7923.                      55, 64, 65, 82, 84,     Software Distribution
  7924.                        94, 98, 102, 116,               System        45, 90
  7925.                       117, 121, 124, 131     source code      5, 66, 89, 90
  7926.                Privil         64, 65, 84     SPAWNBBS.BAT                54
  7927.                Sysop      10-13, 16, 18,     support echo
  7928.                       21-23, 36, 43, 49,          MUFFIN                  5
  7929.                      51, 59, 62, 64, 65,     SYSTEM*.BBS                100
  7930.                         70, 71, 84, 107,     SYSTEM*.DAT                100
  7931.                      108, 110, 111, 119,     TBBS                    8, 118
  7932.                      123, 124, 126, 136,     TheDraw              8, 81, 82
  7933.                                      138     trademarks                1, 7
  7934.                Twit     13, 64, 108, 112     translation characters    107,
  7935.                Worthy             64, 84                      108, 110, 111
  7936.           QM                       8, 98     TSR                         45
  7937.           questionnaire               11     TTY       33, 82, 95, 107, 138
  7938.           QuickBBS            8, 83, 110     TUNES.BBS              62, 137
  7939.           quote          19, 24, 26, 131     user editor    11, 20, 36, 51,
  7940.           QWK                     34, 38                            65, 125
  7941.           RAWDIR.BBS                 136     user file  10, 11, 13, 40, 51,
  7942.           RBBS                    8, 110                   83, 84, 125, 127
  7943.           READER.CTL                         USER.BBS       10, 64, 83, 84,
  7944.                Packet Name            77                         97-99, 133
  7945.           READONLY.BBS               136     USER.DAT                83, 84
  7946.           real name          16, 32, 108     WARRANTY                  1, 2
  7947.           remote sysop logons         11     WaZOO                        7
  7948.           RENUM                       93     WELCOME.BBS    11, 34, 128, 34
  7949.           REP                     34, 38     WELCOME.MEC            11, 127
  7950.           RESTAR*.BBS                105     WildCat!                   110
  7951.           restarting   52, 103, 105, 137     WWIV                  110, 111
  7952.           result codes           42, 124     X00           8, 9, 45, 46, 45
  7953.           reward                      49     Xmodem                   8, 29
  7954.           run   2, 6, 9, 14, 21, 22, 31,     Xmodem-1K                   29
  7955.                      36, 40, 41, 45, 47,     Yell command                13
  7956.                       50-56, 58, 63, 74,     YELL.BBS              136, 138
  7957.                      77, 78, 81, 84, 87,     Ymodem-G                  4, 5
  7958.                      88, 90, 91, 96, 97,     ZIP                  8, 30, 72
  7959.                       99, 100, 102, 103,     Zmodem            4, 8, 29, 30
  7960.                       110, 112, 114-117,
  7961.                                      124
  7962.           SCANBLD  56, 58, 59, 61, 97-99
  7963.           scanner                 58, 60
  7964.           SDSMAX                      90
  7965.           SEAlink              7, 29, 30
  7966.  
  7967.  
  7968.                    Maximus 2.02 System Operations Manual - Page 142
  7969.